skill-developer

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.

Philosophy Change (2025-10-27): We moved away from blocking PreToolUse for Sentry/error handling. Instead, use gentle post-response reminders that don't block workflow but maintain code quality awareness.

✅ 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 最佳實踐創建和管理 Claude Code 技能。在創建新技能、修改 Skill-rules.json、了解觸發模式、使用掛鉤、調試技能激活或實施漸進式披露時使用。涵蓋技能結構、YAML frontmatter、觸發器類型（關鍵字、意圖模式、文件路徑、內容模式）、執行級別（阻止、建議、警告）、掛鉤機制（UserPromptSubmit、PreToolUse）、會話跟踪和 500 行規則。 來源：jpropato/siba。

查看原文