メニュー
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 職業分類に基づく
Strategic search planning for agent-driven research. Generates structured search-term matrices with tiered fallback strategies, engine-specific operators, and grading criteria before executing any searches. Use this skill whenever research requires more than a single search query — comparing technologies, verifying claims across sources, surveying a landscape, investigating a multi-faceted question, or building evidence for a decision. Do NOT use for quick factual lookups, fetching a single known URL, or questions answerable from a single source. Covers tech, academic, regulatory, and general domains. Think of it as "research planning" — the matrix is the plan, execution comes after.
Create language conversion skills for translating code from language A to language B. Use when building 'convert-X-Y' skills, designing type mappings between languages, establishing idiom translation patterns, or defining conversion methodologies. Provides foundational patterns that specific conversion skills extend.
Guide for translating code between programming languages. Use when converting code from one language to another, planning language migrations, understanding conversion challenges, asking about type mappings, idiom translations, or referencing pattern mappings. Covers APTV workflow, type systems, error handling, concurrency, and language-specific gotchas.
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.
{{DESCRIPTION}}
This skill calculates key financial ratios and metrics from financial statement data for investment analysis
| 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 content/skills/my-skill
Checks:
/refine-skill content/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