skill-developer

Enforces guardrails for Claude Code skill activation across two-hook architecture.

1|Updated Nov 7, 2017
One-click install
npx skills add https://github.com/jhouser/actionphase --skill skill-developer-jhouser
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/jhouser/actionphase/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/jhouser/actionphase --skill skill-developer-jhouser

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npm, and includes references (resource) components.

What problem does it solve?

Creating effective Claude Code skills requires understanding trigger mechanisms, enforcement levels, and best practices. This skill provides a comprehensive guide for skill developers, simplifying the process of building, testing, and managing skills that enhance AI automation and enforce project standards.

Core Features & Use Cases

  • Skill Creation Workflow: Guides through creating SKILL.md files, configuring skill-rules.json, and testing triggers.
  • Trigger Types & Enforcement: Explains keyword, intent, file path, and content patterns, along with block, suggest, and warn enforcement levels.
  • Hook Mechanisms: Deep dives into UserPromptSubmit and PreToolUse hooks, including exit code behavior and session state management.
  • Use Case: When you need to create a new skill to enforce a critical coding standard (e.g., database verification) or provide domain-specific guidance, use this skill to define precise triggers, set appropriate enforcement, and ensure your skill integrates seamlessly into the AI's workflow.

Quick Start

Ask for a step-by-step guide to create a new Claude Code skill.

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 with guardrails and trigger rules?

Create a Claude Code skill by defining a SKILL.md frontmatter file, configuring skill-rules.json with trigger patterns (keyword, intent, file path, content), and setting enforcement levels (block, suggest, warn). The skill-developer guide walks through the two-hook architecture—UserPromptSubmit and PreToolUse—to enforce guardrails across your workflow.

What are trigger types and enforcement levels in Claude Code skills?

Trigger types identify when a skill activates: keyword matching, intent detection, file paths, and content patterns. Enforcement levels control the response: block prevents execution, suggest offers guidance, and warn alerts without stopping. Choose based on risk—database operations warrant block, style guidance uses suggest.

How do UserPromptSubmit and PreToolUse hooks work in skill enforcement?

UserPromptSubmit hooks intercept user input before Claude processes it; PreToolUse hooks fire before tool execution. Together they govern skill activation across the workflow, manage session state, and handle exit codes. This two-hook architecture enables precise enforcement points for guardrails like Prisma verification or React component standards.

Can I use skill-rules.json to parse and enforce project-specific standards?

Yes. skill-rules.json drives rule parsing and skill activation based on frontmatter definitions. It supports schema compliance, skip conditions, and block messaging. Use it to enforce standards like database verification or error-handling patterns—the skill handles JSON schema validation and automated testing scaffolds.

What's the best way to test Claude Code skills before deployment?

The skill-developer framework includes automated testing scaffolds to validate trigger patterns and enforcement behavior. Test across scenarios—Prisma workflows, React components, error handling—to verify that keyword/intent and file/content triggers fire correctly at the right hook points with appropriate enforcement levels.

Do I need npm to build and manage Claude Code skills?

Yes, npm is a required dependency for skill development. Use it to manage references and components, configure your skill environment, and run the automated testing scaffolds included in the skill-developer framework.