Skip to content

About

Zero-dependency skill maker & strict validator for AI coding agents (Claude Code, CodeBuddy, Cursor, WorkBuddy, Trae…).

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

skill-maker

English | 中文


English

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/ — Chinese
  • skill-maker-en/ — English

Why this instead of the official skill creator?

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.

What is an Agent Skill?

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/).

Install

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.

Quick start

Once installed, just talk to your agent:

"Build a Skill: turn meeting notes exported from Notion into a weekly report with action items."
"Validate the my-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'

What the validator checks

  • SKILL.md exists and starts with valid YAML frontmatter
  • required name + description present
  • name matches ^[a-z0-9]+(?:-[a-z0-9]+)*$ and equals the folder name
  • description ≤ 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.

Project structure

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

Limitations

  • 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.

Contributing

PRs welcome — especially more references/ patterns and extra linter rules.

License

MIT — see LICENSE.


中文

skill-maker 是一个 Agent Skill(AI 编程助手的能力包),让你的 agent 变成"造 Skill 的工程师"——设计、编写并校验可复用的 Agent Skill。紧凑、有主张、平台无关。

本仓库提供两个语言包,按需安装其一:

  • skill-maker/ — 中文
  • skill-maker-en/ — 英文

为什么不用官方 skill-creator?

skill-maker 典型官方 creator
校验器依赖 零依赖(仅 Python 标准库) 常需 PyYAML
报错方式 一次报全部问题 遇到首个错误即退出
检测本地断链 ✅ ❌ 通常不查
检测残留 TODO ✅ ❌ 通常不查
指导篇幅 约 80 行(省上下文) 350+ 行
强加平台假设 无 有时假定某个 UI 文件

把它当作严格质量门禁 + 省 token 的写作指南来用。

什么是 Agent Skill?

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。

About

Zero-dependency skill maker & strict validator for AI coding agents (Claude Code, CodeBuddy, Cursor, WorkBuddy, Trae…).

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages