AgentSkillsCN

skill-creator

高效技能创建指南。适用于创建新技能,或在现有技能的基础上,通过专业知识、工作流程或工具集成进一步拓展 Claude 的能力时使用。

SKILL.md
--- frontmatter
name: skill-creator
description: Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

Skill Creator

Create modular, self-contained packages that extend AI capabilities with specialized knowledge and workflows.

Core Principles

Concise is Key

Challenge each piece: "Does Claude really need this?" Prefer concise examples over verbose explanations.

Progressive Disclosure

  1. Metadata (~100 words) - Always loaded
  2. SKILL.md body (<500 lines) - When triggered
  3. Bundled resources - As needed

Skill Structure

code
skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter (name, description)
│   └── Markdown instructions
└── Bundled Resources (optional)
    ├── scripts/      - Executable code
    ├── references/   - Documentation
    └── assets/       - Templates, icons

SKILL.md Format

yaml
---
name: my-skill
description: What it does AND when to use it (critical for triggering)
---

# Title

[Core instructions - imperative form]

## Sections as needed

Best Practices

DoDon't
Clear, comprehensive descriptionVague one-liner
Imperative form ("Create", "Run")Passive voice
Concise examplesVerbose explanations
Reference files for detailsEverything in SKILL.md
Test scripts by running themAssume they work

What NOT to Include

  • README.md, CHANGELOG.md, INSTALLATION.md
  • User-facing documentation
  • Setup/testing procedures

Creation Process

  1. Understand - Get concrete usage examples
  2. Plan - Identify reusable scripts/references/assets
  3. Initialize - Create skill directory with SKILL.md
  4. Edit - Implement resources, write instructions
  5. Test - Verify with real usage
  6. Iterate - Refine based on feedback