skill-developer

Create Claude Code skills with a two-hook architecture and auto-activation.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/NmBoyd/claude_setup --skill skill-developer-nmboyd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/NmBoyd/claude_setup/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/NmBoyd/claude_setup --skill skill-developer-nmboyd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates best practices for creating and managing Claude Code skills, enabling auto-activation, guardrails, and progressive disclosure to improve reliability and developer experience.

Core Features & Use Cases

  • Two-hook architecture (UserPromptSubmit for proactive suggestions; PreToolUse as guardrail)
  • Skill rules.json configuration, skip conditions, and session tracking
  • Reference materials and troubleshooting guides to accelerate debugging and onboarding
  • Progressive disclosure: keep SKILL.md concise and use reference files for details

Quick Start

Create a new skill by adding SKILL.md, updating skill-rules.json, and testing triggers with the provided hooks.

Frequently Asked Questions about skill-developer

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

FAQPage Schema
How do I set up Claude Code hooks for auto-activation and guardrails?

To set up Claude Code hooks for auto-activation and guardrails, implement a two-hook architecture using UserPromptSubmit for proactive suggestions and PreToolUse to enforce guardrails. Configure these triggers in your skill-rules.json file to reliably manage skill deployment.

What is progressive disclosure when creating Claude Code skills?

Progressive disclosure in Claude Code skills is a design pattern that keeps your SKILL.md file concise by holding only essential information. It uses separate reference files for detailed documentation, improving reliability and developer onboarding without cluttering the main skill configuration.

How do I configure skip conditions and session tracking for skill rules?

You configure skip conditions and session tracking by defining the specific parameters within your skill-rules.json file. This allows your Claude Code skill to manage auto-activation states and avoid redundant executions during a continuous development session.

What is the best way to structure a Claude Code skill for reliable deployment?

The best way to structure a Claude Code skill for reliable deployment is using a two-hook architecture combined with progressive disclosure. This approach centralizes best practices in a concise SKILL.md, utilizes reference files for details, and enforces guardrails via PreToolUse.

How do I troubleshoot Claude Code skill triggers not firing correctly?

To troubleshoot Claude Code skill triggers not firing correctly, review your skill-rules.json configuration for errors in the UserPromptSubmit hook setup. Use the provided reference materials and troubleshooting guides to debug auto-activation issues and verify your guardrails.