skill-development
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSkill Development
技能开发
Tools for creating, auditing, and maintaining Claude Code skills. Essential for anyone building skills or forking this repository.
用于创建、审核和维护Claude Code技能的工具。对于所有构建技能或复刻本仓库的用户来说都是必备工具。
Slash Commands
斜杠命令
/create-skill <name>
/create-skill <name>/create-skill <name>
/create-skill <name>Scaffold a new skill from templates.
What it does:
- Validates skill name (lowercase-hyphen-case, max 40 chars)
- Asks about skill type (Cloudflare/AI/Frontend/Auth/Database/Tooling/Generic)
- Copies to
templates/skill-skeleton/skills/<name>/ - Auto-populates name and dates in SKILL.md
- Creates README.md with auto-trigger keywords
- Runs metadata check
- Installs skill for testing
Usage:
/create-skill my-new-skill从模板搭建新技能。
功能说明:
- 验证技能名称（小写连字符格式，最长40字符）
- 询问技能类型（Cloudflare/AI/前端/认证/数据库/工具类/通用型）
- 将复制到
templates/skill-skeleton/目录skills/<name>/ - 自动填充SKILL.md中的名称和日期
- 创建包含自动触发关键词的README.md
- 运行元数据检查
- 安装技能以进行测试
使用示例:
/create-skill my-new-skill/review-skill <name>
/review-skill <name>/review-skill <name>
/review-skill <name>Quality review and audit of an existing skill.
What it does:
- Checks SKILL.md structure and metadata
- Validates package versions against latest
- Reviews error documentation
- Checks template completeness
- Suggests improvements
Usage:
/review-skill cloudflare-worker-base对现有技能进行质量评审和审核。
功能说明:
- 检查SKILL.md的结构和元数据
- 验证包版本是否为最新
- 评审错误文档
- 检查模板完整性
- 提出改进建议
使用示例:
/review-skill cloudflare-worker-base/audit [name]
/audit [name]/audit [name]
/audit [name]Multi-agent audit swarm for parallel skill verification.
What it does:
- Launches parallel agents to audit multiple skills
- Checks versions, metadata, content quality
- Generates consolidated report
Usage:
- - Audit all skills
/audit - - Audit matching skills
/audit cloudflare-*
用于并行技能验证的多Agent审核集群。
功能说明:
- 启动并行Agent以审核多个技能
- 检查版本、元数据和内容质量
- 生成整合报告
使用示例:
- - 审核所有技能
/audit - - 审核匹配的技能
/audit cloudflare-*
/audit-skill-deep <name>
/audit-skill-deep <name>/audit-skill-deep <name>
/audit-skill-deep <name>Deep content validation against official documentation.
What it does:
- Fetches official documentation for the skill's technology
- Compares patterns and versions
- Identifies knowledge gaps or outdated content
- Suggests corrections and updates
Usage:
/audit-skill-deep tailwind-v4-shadcn对照官方文档进行深度内容验证。
功能说明:
- 获取技能对应技术的官方文档
- 对比模式和版本
- 识别知识缺口或过时内容
- 提出修正和更新建议
使用示例:
/audit-skill-deep tailwind-v4-shadcn/deep-audit <name>
/deep-audit <name>/deep-audit <name>
/deep-audit <name>Extended deep audit with comprehensive doc scraping.
What it does:
- Scrapes multiple documentation sources
- Caches scraped content in
archive/audit-cache/ - Cross-references with skill content
- Produces detailed accuracy report
Usage:
/deep-audit openai-api扩展型深度审核，包含全面的文档爬取。
功能说明:
- 爬取多个文档来源
- 将爬取的内容缓存到目录
archive/audit-cache/ - 与技能内容进行交叉引用
- 生成详细的准确性报告
使用示例:
/deep-audit openai-api/scrape-api <docs-url> [skill-name]
/scrape-api <docs-url> [skill-name]/scrape-api <docs-url> [skill-name]
/scrape-api <docs-url> [skill-name]Generate a skill from API documentation URL.
What it does:
- Validates the docs URL is accessible and contains API documentation
- Attempts WebFetch first for static docs
- Falls back to Playwright for JS-heavy sites (readme.io, GitBook)
- Extracts endpoints, authentication, request/response schemas
- Generates complete skill structure with SKILL.md, references/, templates/
- Runs plugin manifest generation
Usage:
/scrape-api https://api.example.com/docs my-api- (auto-detects name: rocket-net-api)
/scrape-api https://rocketdotnet.readme.io/
Supported Platforms:
- readme.io documentation sites
- Swagger/OpenAPI specs
- GitBook documentation
- Standard HTML API docs
从API文档URL生成技能。
功能说明:
- 验证文档URL是否可访问且包含API文档
- 优先使用WebFetch获取静态文档
- 针对JS密集型站点（readme.io、GitBook）自动 fallback 到Playwright
- 提取端点、认证方式、请求/响应 schema
- 生成包含SKILL.md、references/、templates/的完整技能结构
- 运行插件清单生成
使用示例:
/scrape-api https://api.example.com/docs my-api- （自动检测名称：rocket-net-api）
/scrape-api https://rocketdotnet.readme.io/
支持平台:
- readme.io文档站点
- Swagger/OpenAPI规范
- GitBook文档
- 标准HTML API文档
Templates
模板
This skill includes templates for creating new skills:
| Template | Purpose |
|---|---|
| Complete skill directory to copy |
| SKILL.md with TODOs to fill |
| README.md with keywords section |
| YAML frontmatter reference |
| Research output format |
| Audit checklist |
本技能包含用于创建新技能的模板:
| 模板 | 用途 |
|---|---|
| 可复制的完整技能目录 |
| 包含待填项的SKILL.md模板 |
| 包含关键词部分的README.md模板 |
| YAML前置元数据参考 |
| 研究输出格式 |
| 审核检查表 |
Using Templates
使用模板
bash
undefinedbash
undefinedOption 1: Use /create-skill (recommended)
选项1：使用/create-skill（推荐）
/create-skill my-new-skill
/create-skill my-new-skill
Option 2: Manual copy
选项2：手动复制
cp -r skills/skill-development/templates/skill-skeleton/ skills/my-new-skill/
cp -r skills/skill-development/templates/skill-skeleton/ skills/my-new-skill/
Then fill in the TODOs
然后填写待填项
---
---Quality Standards
质量标准
Skills should meet these criteria before publishing:
技能在发布前应满足以下标准:
Required
必填项
- YAML frontmatter with and
namedescription - Description includes "Use when" scenarios
- Third-person description style
- Package versions are current
- Templates tested and working
- 包含和
name的YAML前置元数据description - 描述中包含“适用场景”
- 采用第三人称描述风格
- 包版本为当前最新
- 模板已测试且可用
Recommended
推荐项
- README.md with auto-trigger keywords
- Token efficiency measured (target: 50%+ savings)
- Known issues documented with sources
- Examples include error prevention
Full checklist: See in repo root.
ONE_PAGE_CHECKLIST.md- 包含自动触发关键词的README.md
- 已衡量Token效率（目标：节省50%以上）
- 已记录已知问题及来源
- 示例包含错误预防内容
完整检查表: 查看仓库根目录下的。
ONE_PAGE_CHECKLIST.mdAgents
Agent
This skill provides agents for automated skill maintenance:
| Agent | Purpose |
|---|---|
| Scaffold new skills with proper structure |
| Generate skills from API documentation URLs |
| Verify package versions are current |
| Compare skill content vs official docs |
| Validate code examples are syntactically correct |
| Verify documented API methods exist |
| Check documentation quality |
| Apply changes across multiple skills |
These agents are in (repo-level) and (skill-bundled) and used by the commands.
.claude/agents/agents/本技能提供用于自动化技能维护的Agent:
| Agent | 用途 |
|---|---|
| 按规范结构搭建新技能 |
| 从API文档URL生成技能 |
| 验证包版本是否为最新 |
| 对比技能内容与官方文档 |
| 验证代码示例语法正确性 |
| 验证文档中记录的API方法是否存在 |
| 检查文档质量 |
| 跨多个技能应用变更 |
这些Agent位于仓库级目录和技能捆绑目录中，由上述命令调用。
.claude/agents/agents/Workflow
工作流
Creating a New Skill
创建新技能
1. /create-skill my-skill
2. Fill in TODOs in SKILL.md
3. Add templates, references, scripts as needed
4. /review-skill my-skill
5. Fix any issues
6. Test: /plugin install ./skills/my-skill
7. Commit and push1. /create-skill my-skill
2. 填写SKILL.md中的待填项
3. 根据需要添加模板、参考资料和脚本
4. /review-skill my-skill
5. 修复所有问题
6. 测试：/plugin install ./skills/my-skill
7. 提交并推送Auditing Skills
审核技能
1. /audit # Quick check all skills
2. /audit-skill-deep my-skill # Deep check specific skill
3. Review findings
4. Fix issues or document as known limitations
5. Update metadata.last_verified date1. /audit # 快速检查所有技能
2. /audit-skill-deep my-skill # 深度检查指定技能
3. 查看检查结果
4. 修复问题或记录为已知限制
5. 更新metadata.last_verified日期Quarterly Maintenance
季度维护
1. Run: ./scripts/check-all-versions.sh
2. Review VERSIONS_REPORT.md
3. /audit for all skills needing updates
4. Update package versions
5. Test affected skills
6. Commit: "chore: quarterly version updates"1. 运行：./scripts/check-all-versions.sh
2. 查看VERSIONS_REPORT.md
3. 对需要更新的技能执行/audit
4. 更新包版本
5. 测试受影响的技能
6. 提交："chore: quarterly version updates"For Forkers
复刻用户指南
If you've forked this repo to maintain your own skills:
- Install this skill:
/plugin install ./skills/skill-development - Use /create-skill: Creates skills with proper structure
- Use /review-skill: Validates before publishing
- Customize agents: Modify for your needs
.claude/agents/ - Pull upstream updates:
git fetch upstream && git merge upstream/main
The tooling is designed to work standalone - you don't need the full repo to use these commands.
如果你已复刻本仓库以维护自有技能:
- 安装本技能:
/plugin install ./skills/skill-development - 使用/create-skill: 按规范结构创建技能
- 使用/review-skill: 发布前验证技能
- 自定义Agent: 根据需求修改
.claude/agents/ - 拉取上游更新:
git fetch upstream && git merge upstream/main
本工具支持独立运行 - 无需完整仓库即可使用这些命令。