This is the meta-skill for building Claude Code skills themselves. It walks you through the whole system: creating SKILL.md files with proper YAML frontmatter, configuring triggers in skill-rules.json (keywords, intent patterns, file paths), choosing between block/suggest/warn enforcement, and working with the two-hook architecture (UserPromptSubmit for suggestions, plus gentle post-response reminders). The guide covers Anthropic's 500-line rule and progressive disclosure pattern, plus practical stuff like session tracking to avoid nagging and skip conditions when you need an escape hatch. If you're writing custom skills or debugging why one isn't activating, this has the complete reference and testing commands.

skills.sh installs
312
GitHub stars
33.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add davila7/claude-code-templates --skill skill-developer --agent claude-code

Installs into .claude/skills of the current project.

Files

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

System Overview

Two-Hook Architecture

1. UserPromptSubmit Hook (Proactive Suggestions)

  • File: .claude/hooks/skill-activation-prompt.ts
  • Trigger: BEFORE Claude sees user's prompt
  • Purpose: Suggest relevant skills based on keywords + intent patterns
  • Method: Injects formatted reminder as context (stdout → Claude's input)
  • Use Cases: Topic-based skills, implicit work detection

Sponsors

Details

Repository
github.com/davila7/claude-code-templates
Categories
Frontend Development, AI & Agent Building, Debugging
First seen
Jun 3, 2026

More from davila7/claude-code-templates

All 618
1pedronauck avatarstorybook-storiespedronauck/skillsCreate, update, or refactor Storybook stories following the project's standard patterns. Use when adding stories for new components, updating existing stories, 312skills.sh installs
2sattva2020 avatardokploy-api-mcpsattva2020/skillsDeploy and manage applications on Dokploy (self-hosted PaaS). Use when deploying apps, managing Docker Compose services, databases (PostgreSQL, MySQL, MariaDB, 312skills.sh installs
3patricio0312rev avatarcurl-command-generatorpatricio0312rev/skillsGenerates ready-to-run cURL commands from Express, Next.js, Fastify, or other API routes. Creates copy-paste commands with proper headers, authentication, and r308skills.sh installs
4aviz85 avatarpresentation-architectaviz85/claude-skills-libraryTransform high-level ideas or briefs into fully structured presentation scripts saved as Markdown files, describing presentations slide by slide with exhaustive307skills.sh installs
5dfinity avatarcertified-variablesdfinity/icskillsServe cryptographically verified responses from query calls using Merkle trees and subnet BLS signatures. Covers certified data API, RbTree/CertTree constructio302skills.sh installs
6jezweb avatarsveltia-cmsjezweb/claude-skillsSet up Sveltia CMS - lightweight Git-backed CMS successor to Decap/Netlify CMS (300KB bundle, 270+ fixes). Framework-agnostic for Hugo, Jekyll, 11ty, Astro. Pre302skills.sh installs