skill-creator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Creator

Skill 创建器

This skill teaches you how to create Skill Packages—complete directory structures containing guides, scripts, and data.
本Skill将教你如何创建Skill包——包含指南、脚本和数据的完整目录结构。

⚠️ 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")
规则:脚本应接受输出路径参数,允许调用者指定输出位置。Skill目录仅存储代码。
详细指南请查看:
skills_read(path="skills/skill-creator/docs/script-guidelines.md")

What is a Skill Package?

什么是Skill包?

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)

Skill包不只是一个Markdown文件,而是完整的目录结构:
skill-name/
├── SKILL.md          # 入门指南(必填)
├── scripts/          # 可执行脚本
│   ├── main.py
│   └── pyproject.toml  (依赖配置)
├── data/             # 模板和数据文件
└── docs/             # 详细文档(可选)

📖 Choose Guide by Scenario

📖 按场景选择指南

Based on your needs, read the corresponding detailed documentation:
根据你的需求,阅读对应的详细文档:

🆕 Create New Skill from Scratch

🆕 从零创建新Skill

First time creating a skill package, learn the complete process (5-step creation method).
python
skills_read(path="skills/skill-creator/docs/quick-start.md")
首次创建Skill包,学习完整流程(5步创建法)。
python
skills_read(path="skills/skill-creator/docs/quick-start.md")

📝 Write/Modify SKILL.md Documentation

📝 编写/修改SKILL.md文档

Learn the structure and template for SKILL.md.
python
skills_read(path="skills/skill-creator/docs/skillmd-template.md")
学习SKILL.md的结构和模板。
python
skills_read(path="skills/skill-creator/docs/skillmd-template.md")

🔧 Add Scripts to Skill

🔧 为Skill添加脚本

Learn Python/Bash script writing standards and dependency management.
python
skills_read(path="skills/skill-creator/docs/script-guidelines.md")
学习Python/Bash脚本编写规范和依赖管理。
python
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.
python
skills_read(path="skills/skill-creator/docs/iteration-and-cleanup.md")
创建替换脚本后如何正确清理旧版本。
python
skills_read(path="skills/skill-creator/docs/iteration-and-cleanup.md")

📚 View Complete Example

📚 查看完整示例

Reference a complete skill creation process (code reviewer skill).
python
skills_read(path="skills/skill-creator/docs/full-example.md")

参考完整的Skill创建流程(代码评审Skill)。
python
skills_read(path="skills/skill-creator/docs/full-example.md")

Command Quick Reference

命令快速参考

ToolPurposeExample
skills_ls(path="skills")
List all skillsView available skills
skills_ls(path="skills/<name>")
List files in skillCheck file structure
skills_read(path="skills/<name>/SKILL.md")
Read skill documentationLearn skill usage
skills_create(name, description, instructions)
Create skill skeletonCreate new skill
skills_write(path, content)
Add/overwrite fileAdd script
skills_run(name, command)
Execute skill commandTest script
skills_bash(command, cwd)
Execute shell commandDelete/rename file

工具用途示例
skills_ls(path="skills")
列出所有Skill查看可用Skill
skills_ls(path="skills/<name>")
列出Skill中的文件检查文件结构
skills_read(path="skills/<name>/SKILL.md")
阅读Skill文档学习Skill用法
skills_create(name, description, instructions)
创建Skill骨架创建新Skill
skills_write(path, content)
添加/覆盖文件添加脚本
skills_run(name, command)
执行Skill命令测试脚本
skills_bash(command, cwd)
执行shell命令删除/重命名文件

Quick Start

快速开始

Creating the simplest skill requires only 2 steps:
python
undefined
创建最简单的Skill仅需2步:
python
undefined

1. Create skill skeleton

1. 创建Skill骨架

skills_create( name="hello-world", description="Example skill", instructions="# Hello World\n\nRun
skills_run(name=\"hello-world\", command=\"python scripts/hello.py\")
" )
skills_create( name="hello-world", description="示例Skill", instructions="# Hello World\n\nRun
skills_run(name=\"hello-world\", command=\"python scripts/hello.py\")
" )

2. Add script

2. 添加脚本

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

3. Test

3. 测试

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

Need more detailed guidance? Read [Quick Start Guide](docs/quick-start.md).
skills_run(name="hello-world", command="python scripts/hello.py")

需要更详细的指引?阅读[快速入门指南](docs/quick-start.md)。