Skill(スキル)の書き方と本質 / How Skills Work
- 日本語
- English
- 简体中文
Skillとは「あなたの会社の業務マニュアル」
一般的なLLM(ChatGPTなど)は、プログラミングや文章作成の基本は知っていますが、**「あなたの会社やプロジェクトでの独自のルール」**は知りません。
OpenClawにおける「Skill」とは、AIにその独自ルールを正確に教え込み、特定の仕事をいつ、どんな手順で、どのクオリティで完了させるべきかを定義した「業務マニュアル」そのものです。
📦 Skillの構造
1つのSkillは、1つのフォルダとして管理されます。そのフォルダの中に必要な道具を全てパッケージ化します。
SKILL.md(必須): AIが必ず最初に読む「手順書」です。/scripts: その業務でAIに実行させるPythonやShellスクリプト。/examples: 見本となるテキストや画像(これを見ればAIがアウトプットの真似をしやすくなります)。
graph TD;
A[あなたの依頼] --> B[メインのAI];
B --「あ、この仕事はスキルを使おう」--> C{Skillフォルダ};
C --> D[SKILL.md を読んで手順を理解];
C --> E[参考データ (examples) を確認];
C --> F[スクリプト (scripts) を実行];
F --> G[完璧な成果物 ✨];
📝 SKILL.md の書き方
AIに向けて、**「人間が新入社員に仕事の流れを教えるトーン」**で書いてください。プロンプトエンジニアリングの極意は「箇条書きで具体的に」です。
# YouTube動画の要約スキル
## 1. 目的
URLを受け取り、そのYouTube動画の内容を要約してMarkdownで出力すること。
## 2. 手順
1. `scripts/download_subs.py` を実行して字幕を取得してください。
2. 字幕を読み、重要な3つのポイントを箇条書きにしてください。
3. `examples/output_format.md` の形式に従って文書を整形してください。
## 3. 注意点
* ギャグや無駄話は要約に含めないでください。
A Skill is "Your Company's SOP Manual"
A general LLM (like ChatGPT) knows the basics of coding or writing, but it doesn't know the unique rules and conventions of your specific project or company.
In OpenClaw, a "Skill" is essentially a standard operating procedure (SOP) manual. It accurately teaches the AI those unique rules, defining when, in what sequence, and at what quality a specific task must be completed.
📦 The Architecture of a Skill
A single Skill is managed as a single folder. You package all the necessary tools for that workflow inside it.
SKILL.md(Required): The "Instruction Manual" the AI reads first./scripts: Python or Shell scripts the AI is allowed to execute for this job./examples: Sample texts or images (the AI mimics these to generate perfect outputs).
graph TD;
A[Your Request] --> B[Main AI Agent];
B --"Ah, I'll use a Skill for this"--> C{Skill Folder};
C --> D[Reads SKILL.md to grasp steps];
C --> E[Checks Reference Data (examples)];
C --> F[Executes Scripts (scripts)];
F --> G[Perfect Deliverable ✨];
📝 How to Write SKILL.md
Write it in the tone of "a human teaching a workflow to a new employee." The secret to prompt engineering here is "be specific and use bullet points."
# YouTube Summary Skill
## 1. Objective
Receive a URL, summarize the YouTube video's content, and output it in Markdown.
## 2. Steps
1. Run `scripts/download_subs.py` to fetch the subtitles.
2. Read the subtitles and extract 3 key bullet points.
3. Format the document strictly following `examples/output_format.md`.
## 3. Constraints
* Ignore jokes or small talk in your summary.
Skill 就是“您公司的标准作业程序 (SOP) 手册”
通用的 LLM(例如 ChatGPT)虽然懂得编程或写作的基础,但它们并不知道您公司或项目特有的内部规定和流程。
在 OpenClaw 中,“Skill(技能)”本质上就是一份业务操作手册。它准确地向 AI 灌输这些独门规则,定义了 AI 应该在何时、按什么先后顺序、以何种质量标准去完成一项特定的工作。
📦 Skill 的结构组成
一个 Skill 就是一个独立的文件夹。您需要把该工作流所需的所有“工具”都打包在里面。
SKILL.md(必备):这是 AI 首要拜读的“指导手册”。/scripts:让 AI 在执行此业务时调用的 Python 或 Shell 脚本。/examples:范例文本或参考图像(看到优秀的参考,AI 就能模仿生成更完美的成果)。
graph TD;
A[您的委托] --> B[管家 AI];
B --"啊,这个差事需要调用技能套件"--> C{Skill 文件夹};
C --> D[阅读 SKILL.md 掌握步骤];
C --> E[查阅参考数据 (examples)];
C --> F[执行内部脚本 (scripts)];
F --> G[完美的交付物 ✨];
📝 如何编写 SKILL.md
请以**“人类老员工带新员工走流程的口吻”**来书写。此处的提示词(Prompt)工程的秘诀就是“使用清晰、具体的项目符号(条目)”。
# YouTube 视频摘要技能
## 1. 目标
接收用户提供的 URL,对该 YouTube 视频的内容进行总结,并以 Markdown 格式输出。
## 2. 操作步骤
1. 请执行 `scripts/download_subs.py` 以获取视频字幕。
2. 阅读字幕内容,并提炼成 3 个关键点(使用列表)。
3. 请严格按照 `examples/output_format.md` 中的格式对最终文档进行排版。
## 3. 注意事项
* 摘要中绝对不要包含原视频里的玩笑话或闲聊部分。