write-a-skill by mattpocock/skills
npx skills add https://github.com/mattpocock/skills --skill write-a-skilltemplate with quick start, workflows, and advanced features sections; splits content into separate reference files when exceeding 100 lines
SKILL.md
skill-name/
├── SKILL.md # 主要指令(必需)
├── REFERENCE.md # 详细文档(如果需要)
├── EXAMPLES.md # 使用示例(如果需要)
└── scripts/ # 实用脚本(如果需要)
└── helper.js
---
name: skill-name
description: 能力简述。在[特定触发条件]时使用。
---
# 技能名称
## 快速开始
[最小工作示例]
## 工作流程
[针对复杂任务的逐步流程和检查清单]
## 高级功能
[链接到单独的文件:参见 [REFERENCE.md](REFERENCE.md)]
描述是。它会与所有其他已安装技能的描述一起显示在系统提示中。您的代理会读取这些描述,并根据用户的请求选择相关的技能。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
目标:为您的代理提供足够的信息,使其知道:
格式:
好的示例:
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
差的示例:
Helps with documents.
差的示例无法让您的代理将此技能与其他文档技能区分开来。
在以下情况下添加实用脚本:
与生成的代码相比,脚本可以节省令牌并提高可靠性。
在以下情况下拆分为单独的文件:
起草后,请验证:
每周安装量
1.3K
代码仓库
GitHub 星标数
10.2K
首次出现
2026年2月12日
安全审计
安装于
opencode1.3K
codex1.3K
gemini-cli1.2K
github-copilot1.2K
amp1.2K
kimi-cli1.2K
template with quick start, workflows, and advanced features sections; splits content into separate reference files when exceeding 100 lines
SKILL.md
Gather requirements - ask user about:
Draft the skill - create:
Review with user - present draft and ask:
skill-name/
├── SKILL.md # Main instructions (required)
├── REFERENCE.md # Detailed docs (if needed)
├── EXAMPLES.md # Usage examples (if needed)
└── scripts/ # Utility scripts (if needed)
└── helper.js
---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---
# Skill Name
## Quick start
[Minimal working example]
## Workflows
[Step-by-step processes with checklists for complex tasks]
## Advanced features
[Link to separate files: See [REFERENCE.md](REFERENCE.md)]
The description is the only thing your agent sees when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
Goal : Give your agent just enough info to know:
Format :
Good example :
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
Bad example :
Helps with documents.
The bad example gives your agent no way to distinguish this from other document skills.
Add utility scripts when:
Scripts save tokens and improve reliability vs generated code.
Split into separate files when:
After drafting, verify:
Weekly Installs
1.3K
Repository
GitHub Stars
10.2K
First Seen
Feb 12, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode1.3K
codex1.3K
gemini-cli1.2K
github-copilot1.2K
amp1.2K
kimi-cli1.2K
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
102,200 周安装