skill-maker is an Agent Skill that turns your AI coding agent into a "skill engineer" — design, write, and validate reusable Agent Skills. Compact, opinionated, platform-agnostic.
This repository ships two language packages — install the one you prefer:
skill-maker/— Chineseskill-maker-en/— English
| skill-maker | typical official creator | |
|---|---|---|
| Validator dependencies | none (Python stdlib only) | often needs PyYAML |
| Error reporting | all issues at once | stops at first error |
| Detects broken local links | ✅ | ❌ often |
| Detects TODO/FIXME leftovers | ✅ | ❌ often |
| Guidance size | ~80 lines (fits in context) | 350+ lines |
| Imposed platform assumptions | none | sometimes a specific UI file |
Use it as a strict quality gate plus a token-efficient authoring guide for your own skills.
An Agent Skill is a folder with a SKILL.md that teaches an AI agent when and how to do a repeatable task — onboarding docs for a specific job. skill-maker helps you write those. The format follows the public Agent Skills specification (name + description frontmatter; optional scripts/, references/, assets/).
Copy the language package you want into your agent's skills directory:
# Chinese
cp -r skill-maker ~/.agents/skills/skill-maker # Claude Code / agentskills
cp -r skill-maker ~/.codebuddy/skills/skill-maker # CodeBuddy / WorkBuddy
# English
cp -r skill-maker-en ~/.agents/skills/skill-maker-en
cp -r skill-maker-en ~/.codebuddy/skills/skill-maker-en
# Cursor / other agents: place under your agent's skills dir (e.g. .cursor/skills/)Or use your agent's Import Skill UI and select the folder. No build step, no dependencies.
Once installed, just talk to your agent:
"Build a Skill: turn meeting notes exported from Notion into a weekly report with action items."
"Validate themy-skill/package I just wrote."
Lint any skill yourself:
python skill-maker/scripts/quick_validate.py path/to/your-skill
# ✅ passed: path/to/your-skill
# error: directory name 'my_skill' should match frontmatter name 'my-skill'SKILL.mdexists and starts with valid YAML frontmatter- required
name+descriptionpresent namematches^[a-z0-9]+(?:-[a-z0-9]+)*$and equals the folder namedescription≤ 1024 chars, no<>- no leftover
TODO/FIXME/[placeholder] - no broken local links to
references/,scripts/,assets/
Exits non-zero on any failure — safe to drop into CI.
skill-maker/ # Chinese package
├── SKILL.md
├── scripts/quick_validate.py
└── references/design-patterns.md
skill-maker-en/ # English package
├── SKILL.md
├── scripts/quick_validate.py
└── references/design-patterns.md
- Structural gate only — it does not prove the Skill runs on a real platform; test it there.
- No scaffolding / packaging tool (use your agent or another creator for that).
- Guidance is intentionally concise; pair with the official Agent Skills spec for depth.
PRs welcome — especially more references/ patterns and extra linter rules.
MIT — see LICENSE.
skill-maker 是一个 Agent Skill(AI 编程助手的能力包),让你的 agent 变成"造 Skill 的工程师"——设计、编写并校验可复用的 Agent Skill。紧凑、有主张、平台无关。
本仓库提供两个语言包,按需安装其一:
skill-maker/— 中文skill-maker-en/— 英文
| skill-maker | 典型官方 creator | |
|---|---|---|
| 校验器依赖 | 零依赖(仅 Python 标准库) | 常需 PyYAML |
| 报错方式 | 一次报全部问题 | 遇到首个错误即退出 |
| 检测本地断链 | ✅ | ❌ 通常不查 |
| 检测残留 TODO | ✅ | ❌ 通常不查 |
| 指导篇幅 | 约 80 行(省上下文) | 350+ 行 |
| 强加平台假设 | 无 | 有时假定某个 UI 文件 |
把它当作严格质量门禁 + 省 token 的写作指南来用。
Agent Skill 是一个带 SKILL.md 的文件夹,教 AI agent 何时、如何完成一件可重复的任务——相当于某个具体岗位的入职文档。skill-maker 帮你写这种文档。格式遵循公开的 Agent Skills 规范(name + description 前置元数据;可选 scripts/、references/、assets/)。
把想要的语言包复制到 agent 的 skills 目录:
# 中文
cp -r skill-maker ~/.agents/skills/skill-maker # Claude Code / agentskills
cp -r skill-maker ~/.codebuddy/skills/skill-maker # CodeBuddy / WorkBuddy
# 英文
cp -r skill-maker-en ~/.agents/skills/skill-maker-en
cp -r skill-maker-en ~/.codebuddy/skills/skill-maker-en
# Cursor / 其他 agent:放到对应 skills 目录(如 .cursor/skills/)或用 agent 的导入技能(Import Skill)功能选中文件夹。无需构建、无依赖。
安装后,直接跟 agent 说:
"做一个 Skill:把 Notion 导出的会议纪要整理成带行动项的周报。"
"校验一下我刚写的my-skill/包有没有问题。"
也可以自己跑校验:
python skill-maker/scripts/quick_validate.py path/to/your-skill
# ✅ 通过:path/to/your-skill
# 错误:目录名 'my_skill' 应与 frontmatter 的 name 'my-skill' 一致SKILL.md存在且以合法 YAML frontmatter 开头- 必需的
name+description齐全 name匹配^[a-z0-9]+(?:-[a-z0-9]+)*$且与文件夹名一致description≤ 1024 字符、不含<>- 无残留
TODO/FIXME/[placeholder] - 无指向
references/、scripts/、assets/的断链
任一失败即非零退出——可直接接入 CI。
skill-maker/ # 中文包
├── SKILL.md
├── scripts/quick_validate.py
└── references/design-patterns.md
skill-maker-en/ # 英文包
├── SKILL.md
├── scripts/quick_validate.py
└── references/design-patterns.md
- 仅为结构门禁——不能证明 Skill 在真实平台可用,需在那边实测。
- 无脚手架 / 打包工具(需要时用你的 agent 或其他 creator)。
- 指导刻意精简;深度内容请配合官方 Agent Skills 规范。
欢迎 PR——尤其是更多 references/ 模式与额外校验规则。
MIT——见 LICENSE。