skill-developer

Installation
Summary

Create and manage Claude Code skills with auto-activation triggers, following Anthropic best practices and the 500-line rule.

  • Two-hook architecture: UserPromptSubmit for proactive skill suggestions based on keywords and intent patterns, and Stop hook for gentle error-handling reminders after responses
  • Three skill types with different enforcement levels: guardrail skills (block critical mistakes), domain skills (suggest best practices), and warning skills (advisory only)
  • Configuration via .claude/skills/skill-rules.json with support for keyword triggers, intent patterns, file path globs, content regex patterns, and skip conditions (session tracking, file markers, environment variables)
  • Comprehensive reference documentation covering trigger types, hook mechanisms, troubleshooting, and a ready-to-use pattern library for common scenarios
SKILL.md

Skill Developer Guide

Purpose

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.

When to Use This Skill

Automatically activates when you mention:

  • Creating or adding skills
  • Modifying skill triggers or rules
  • Understanding how skill activation works
  • Debugging skill activation issues
  • Working with skill-rules.json
  • Hook system mechanics
  • Claude Code best practices
  • Progressive disclosure
  • YAML frontmatter
  • 500-line rule
Related skills
Installs
499
GitHub Stars
37.3K
First Seen
Jan 19, 2026