skills.rest
chacha95
chacha95COMMUNITY
Explore all skills by this author →
GitHub

skill-developer

Create and manage Claude Code skills with SKILL.md and skill-rules.json.

51|39|Updated Dec 30, 2025
Search Tags:#automation#documentation#hooks#best-practices#skill-development#claude-code#trigger-patterns
One-click install
npx skills add https://github.com/chacha95/claude-code-harness --skill skill-developer-chacha95
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/chacha95/claude-code-harness/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/chacha95/claude-code-harness --skill skill-developer-chacha95

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Standardizes the process of creating and managing Claude Code skills to reduce confusion and misconfiguration across teams.

Core Features & Use Cases

It covers the two-hook architecture (UserPromptSubmit and PreToolUse), the required SKILL.md frontmatter, the skill-rules.json configuration, and the use of reference files for progressive disclosure. It documents how to create, modify, test, and troubleshoot skills for guardrail and domain types, including how hooks work and how to structure Skill content.

Quick Start

Follow the Step-by-Step Quick Start to create a new skill in .claude/skills/{name}/SKILL.md and register it in skill-rules.json to enable auto-activation.

Frequently Asked Questions about skill-developer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code skill that auto-activates based on trigger patterns?▼

To create a Claude Code skill, place a SKILL.md file with required frontmatter in .claude/skills/{name}/, then register it in skill-rules.json to enable trigger-based auto-activation.

What is the two-hook architecture in Claude Code skill development?▼

The two-hook architecture uses UserPromptSubmit and PreToolUse hooks to apply guardrails and domain-specific rules automatically, reducing manual configuration overhead during skill execution.

How do I structure SKILL.md to enforce the 500-line guideline and progressive disclosure?▼

Structure SKILL.md by keeping core content under 500 lines and moving detailed instructions into separate reference files, enabling progressive disclosure for Claude Code skill readers.

Why does my Claude Code skill not trigger automatically when I submit a prompt?▼

Auto-activation fails when SKILL.md lacks proper frontmatter or the skill is missing an entry in skill-rules.json, preventing the trigger patterns from matching user prompts.

Can I update existing guardrail and domain skills without breaking hook behavior?▼

Yes, you can update rules and validate hook behavior across guardrail and domain skills by modifying the SKILL.md content and testing trigger patterns to ensure proper auto-activation.

What's the best way to troubleshoot Claude Code skills that are not applying guardrails correctly?▼

Troubleshoot guardrail skills by validating the SKILL.md frontmatter, checking the skill-rules.json registration, and testing PreToolUse and UserPromptSubmit hook behavior for trigger pattern mismatches.

Related Skills

Explore More Software Engineering Skills→
enbiyagoralenbiyagoral
2

new-skill

Generate a standardized SKILL.md and directory scaffold for Claude Code skills.

Community
Intermediate
Bliz243Bliz243

skill-creator

Create and manage Claude Code skills with SKILL.md structure and frontmatter validation.

Community
Basic
Venture-FormationsVenture-Formations
1

skill-developer

Automates the creation and upkeep of Claude Code skills with SKILL.md frontmatter.

Official
Advanced
kid-sidkid-sid
18

codex-orchestration

Diagnose OpenAI Codex CLI orchestration misconfigurations and debugging challenges.

Community
Intermediate