菜单
Validate Claude Code skills against best practices. Use when checking skill quality, running validation, or creating improvement issues.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Developing custom GitHub Actions (JavaScript, TypeScript, Docker, Composite). Use this skill when the user asks to 'create a GitHub Action', 'build a custom action', 'publish action to marketplace', 'write action.yml', or 'develop reusable action'.
Use when creating new skills, editing existing skills, initializing skill structure, packaging skills for distribution, or verifying skills work before deployment. This skill applies TDD methodology to documentation.
Identify skill coverage gaps and improvement opportunities. Use when analyzing missing skills for a task, creating skill gap issues, evaluating skill effectiveness, or refining skill progressive disclosure.
Create, test, and maintain Homebrew formulas. Use when adding packages to a Homebrew tap, debugging formula issues, running brew audit/test, or automating version updates with livecheck.
| name | meta-skill-validation-dev |
| description | Validate Claude Code skills against best practices. Use when checking skill quality, running validation, or creating improvement issues. |
Framework for validating Claude Code skills against best practices. This skill provides checklists and templates used by validation commands.
| Resource | Purpose |
|---|---|
| checklists/frontmatter.md | Name, description, required fields |
| checklists/structure.md | Token budget, progressive disclosure |
| checklists/quality.md | Content quality checks |
| checklists/8-pillars.md | 8+1 Pillar coverage for lang/convert skills |
| templates/issue-templates.md | GitHub issue body templates |
| Level | Scope | Command |
|---|---|---|
| Quick | Naming, frontmatter, SKILL.md exists | just validate-skill <path> |
| Standard | + Token budget, structure, quality | /refine-skill --check-only |
| Deep | + 8 Pillars, meta-skill compliance | /validate-lang-conversion-skill |
just validate-skill components/skills/my-skill
Checks:
/refine-skill components/skills/my-skill --check-only
Adds:
/validate-lang-conversion-skill convert-python-rust
# Or for pillar coverage only:
just validate-pillars lang-rust-dev
Adds:
| Severity | Definition | Action |
|---|---|---|
| Critical | Blocks functionality, must fix before use | Create bug issue |
| Warning | Should fix, impacts quality | Create enhancement issue |
| Suggestion | Nice to have, improves experience | Create docs issue |
| Check | Critical | Warning | Pass |
|---|---|---|---|
| SKILL.md lines | > 800 | 500-800 | < 500 |
| Description length | > 300 chars | vague/missing | < 200, trigger words |
| 8 Pillars score | < 4/8 | 4-5.5/8 | >= 6/8 |
| 9 Pillars score | < 5/9 | 5-6.5/9 | >= 7/9 |
| Type mappings | < 5 | 5-14 | >= 15 |
| Pitfalls listed | 0-2 | 3-4 | >= 5 |
This skill documents validation criteria. Automation lives in justfile:
| Recipe | Purpose |
|---|---|
validate-skill <path> | Quick structural validation |
validate-pillars <skill> | 8 pillars coverage check |
validate-all-skills | Batch validation |
validate-all-lang-skills | Batch lang skill validation |
# All skills
just validate-all-skills
# Lang skills only (with pillar coverage)
just validate-all-lang-skills
# Single skill with pillars
just validate-pillars lang-rust-dev
/create-skill or manual creationjust validate-skill <path> - quick check/refine-skill --check-only - full check/create-lang-conversion-skill/validate-lang-conversion-skill - includes pillar coverage# Add to pre-commit config
- repo: local
hooks:
- id: validate-skills
name: Validate Skills
entry: just validate-all-skills
language: system
pass_filenames: false