Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー。 Anthropic公式ガイド(2026-03)準拠。新規スキル作成、既存スキルの改善、 description品質チェック、トリガーテスト設計に使用。 「スキル作って」「スキル設計」「SKILL.md作成」「スキルレビュー」で起動。 Do NOT use for: スキルの実行・呼び出し(それは各スキル自体が行う)。
72
88%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that clearly defines its meta-purpose (creating and reviewing SKILL.md files), provides explicit trigger terms in Japanese, and includes a helpful exclusion clause. It covers all four dimensions strongly with specific actions, natural keywords, complete what/when guidance, and a distinctive niche. The only minor note is that it's in Japanese which limits its utility to Japanese-speaking users, but within that context it is excellent.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 設計(design), 作成(creation), バリデーション(validation), レビュー(review) of SKILL.md files, plus sub-actions like 新規スキル作成, 既存スキルの改善, description品質チェック, トリガーテスト設計. | 3 / 3 |
Completeness | Clearly answers both 'what' (design, create, validate, review SKILL.md files per Anthropic guidelines) and 'when' (explicit trigger phrases provided, plus a 'Do NOT use for' exclusion clause that further clarifies scope). The trigger guidance is explicit with quoted example phrases. | 3 / 3 |
Trigger Term Quality | Includes natural trigger terms users would say in Japanese: 「スキル作って」「スキル設計」「SKILL.md作成」「スキルレビュー」. Also includes terms like 'SKILL.md', 'スキル', 'description品質チェック' which are natural keywords for this domain. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche focused specifically on SKILL.md meta-creation and review, distinct from skills that actually perform tasks. The 'Do NOT use for' clause explicitly excludes skill execution, reducing conflict risk with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable meta-skill for creating Claude Code skills. Its greatest strengths are the concrete examples (good/bad description comparisons, executable validation scripts, specific file paths) and the clear 12-step creation workflow with validation checkpoints. Its main weakness is that it doesn't follow its own advice about progressive disclosure—the content is dense and monolithic, and some sections (like the full frontmatter reference and 5 design patterns) could be split into reference files to reduce token cost.
Suggestions
Practice what you preach: split the full frontmatter reference, 5 design patterns, and anti-patterns table into references/ files, keeping only summaries and links in SKILL.md
Remove explanations of concepts Claude already knows (e.g., what kebab-case means, that YAML frontmatter exists) to improve conciseness
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some content Claude already knows (e.g., explaining what kebab-case is, basic YAML concepts). The frontmatter reference section is thorough but could be more concise—many fields have obvious meanings. The anti-patterns table and some explanatory text add bulk. However, much of the domain-specific knowledge (description design, triggering patterns, progressive disclosure layers) genuinely adds value. | 2 / 3 |
Actionability | The skill provides highly concrete, actionable guidance: the 7-item description checklist with good/bad examples, the 12-step creation workflow, executable validation script examples, specific file structure paths, exact character limits, and concrete trigger test examples. The frontmatter reference is copy-paste ready with inline comments explaining each field. | 3 / 3 |
Workflow Clarity | The 12-step Creation Workflow is clearly sequenced with logical dependencies (identify use case → categorize → design description → check duplicates → write → validate → test → deploy). Validation is explicitly called out at step 10 with a concrete script example. The 3-domain test strategy provides clear verification checkpoints. The description debugging technique ('ask Claude when it would use the skill') serves as a feedback loop. | 3 / 3 |
Progressive Disclosure | The skill itself teaches progressive disclosure (L1/L2/L3 layers) and recommends references/ for detailed content, but ironically doesn't practice it well—the SKILL.md is a long monolithic document (~400 lines) that could benefit from splitting the frontmatter reference, design patterns, and anti-patterns into separate reference files. No bundle files are provided despite the skill recommending that structure for others. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
bb19915
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.