Skill Creator

This skill teaches you how to create Skill Packages—complete directory structures containing guides, scripts, and data.

⚠️ Path Guidelines

Rule: Scripts should accept output path parameters, letting callers specify output locations. Skill directories only store code.

For detailed guidelines: skills_read(path="skills/skill-creator/docs/script-guidelines.md")

What is a Skill Package?

A skill package is not just a Markdown file, but a complete directory structure:

skill-name/
├── SKILL.md          # Entry guide (required)
├── scripts/          # Executable scripts
│   ├── main.py
│   └── pyproject.toml  (dependency config)
├── data/             # Templates and data files
└── docs/             # Detailed documentation (optional)

📖 Choose Guide by Scenario

Based on your needs, read the corresponding detailed documentation:

🆕 Create New Skill from Scratch

First time creating a skill package, learn the complete process (5-step creation method).

skills_read(path="skills/skill-creator/docs/quick-start.md")

📝 Write/Modify SKILL.md Documentation

Learn the structure and template for SKILL.md.

skills_read(path="skills/skill-creator/docs/skillmd-template.md")

🔧 Add Scripts to Skill

Learn Python/Bash script writing standards and dependency management.

skills_read(path="skills/skill-creator/docs/script-guidelines.md")

🔄 Script Debugging Failed, Need Iteration

How to properly clean up old versions after creating replacement scripts.

skills_read(path="skills/skill-creator/docs/iteration-and-cleanup.md")

📚 View Complete Example

Reference a complete skill creation process (code reviewer skill).

skills_read(path="skills/skill-creator/docs/full-example.md")

Command Quick Reference

Tool	Purpose	Example
`skills_ls(path="skills")`	List all skills	View available skills
`skills_ls(path="skills/<name>")`	List files in skill	Check file structure
`skills_read(path="skills/<name>/SKILL.md")`	Read skill documentation	Learn skill usage
`skills_create(name, description, instructions)`	Create skill skeleton	Create new skill
`skills_write(path, content)`	Add/overwrite file	Add script
`skills_run(name, command)`	Execute skill command	Test script
`skills_bash(command, cwd)`	Execute shell command	Delete/rename file

Quick Start

Creating the simplest skill requires only 2 steps:

# 1. Create skill skeleton
skills_create(
    name="hello-world",
    description="Example skill",
    instructions="# Hello World\n\nRun `skills_run(name=\"hello-world\", command=\"python scripts/hello.py\")`"
)

# 2. Add script
skills_write(
    path="skills/hello-world/scripts/hello.py",
    content='print("Hello, World!")'
)

# 3. Test
skills_run(name="hello-world", command="python scripts/hello.py")

Need more detailed guidance? Read Quick Start Guide.