writing-skills

SKILL.md

Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.

Guardrail skills with blocking enforcement ("block") are designed but not yet implemented. These would enforce critical patterns and prevent common mistakes.

✅ Keep SKILL.md under 500 lines ✅ Use progressive disclosure with reference files ✅ Add table of contents to reference files > 100 lines ✅ Write detailed description with trigger keywords ✅ Test with 3+ real scenarios before documenting ✅ Iterate based on actual usage

Anthropic のベスト プラクティスに従って、HASH リポジトリで Claude Code スキルを作成および管理します。新しいスキルの作成、skill-rules.jsonの変更、トリガーパターンの理解、フックの操作、スキルアクティベーションのデバッグ、またはプログレッシブ開示の実装時に使用します。スキル構造、YAML フロントマター、トリガー タイプ (キーワード、インテント パターン)、UserPromptSubmit フック、および 500 行ルールについて説明します。 SKILL_DEBUG による検証とデバッグが含まれます。例としては、Rust-Error-Stack、Cargo の依存関係、Rust-Documentation スキルなどがあります。 ソース: microck/ordinary-claude-skills。

原文を見る