skill-developer

Create and govern Claude Code skills with YAML frontmatter and trigger rules.

Updated May 8, 2025
One-click install
npx skills add https://github.com/mbelenmontoya/design-token-manager-api --skill skill-developer-mbelenmontoya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/mbelenmontoya/design-token-manager-api/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/mbelenmontoya/design-token-manager-api --skill skill-developer-mbelenmontoya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It provides a best-practice blueprint for creating and maintaining Claude Code skills, ensuring consistent structure, triggers, and guardrails across projects.

Core Features & Use Cases

  • Documentation scaffolding for skill files (SKILL.md) and frontmatter
  • Clear guidance on trigger types (keywords, intent patterns, file paths, content patterns)
  • Enforcement levels and hook mechanisms (UserPromptSubmit, PreToolUse) with session tracking and troubleshooting references
  • Practical guidance for debugging skill activation and progressive disclosure workflows

Quick Start

Create a new skill by adding a folder under .claude/skills with SKILL.md frontmatter and a corresponding entry in skill-rules.json, then test the triggers using the manual test commands described in the guide.

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 proper frontmatter and trigger rules?

To create a Claude Code skill, add a folder under .claude/skills with a SKILL.md file containing YAML frontmatter and a corresponding entry in skill-rules.json, then test the triggers using manual commands. This ensures proper skill activation and governance.

What trigger types can I use for Claude Code skill activation?

Claude Code skill activation supports keyword triggers, intent patterns, file paths, and content patterns. These trigger types are defined in the skill-rules.json file and governed by enforcement levels with hook mechanisms like UserPromptSubmit and PreToolUse.

Why does my Claude Code skill not activate when I expect it to?

Skill activation debugging requires checking frontmatter compliance, validating trigger rules in skill-rules.json, and verifying hook mechanisms like UserPromptSubmit and PreToolUse. Progressive disclosure workflows and session tracking references help troubleshoot activation flow issues.

What files do I need to set up a new Claude Code skill?

Setting up a Claude Code skill requires a SKILL.md file with YAML frontmatter and a skill-rules.json entry. Reference materials and documentation scaffolding ensure compliance with structural requirements and the 500-line rule for skill content.

Can I use hooks like UserPromptSubmit and PreToolUse for Claude Code skill enforcement?

Yes, Claude Code skills support enforcement hooks including UserPromptSubmit and PreToolUse with session tracking. These mechanisms govern when skills activate and provide troubleshooting references for debugging activation flows across frontmatter and trigger rules.

What is the 500-line rule for Claude Code skills and when does it apply?

The 500-line rule is a compliance constraint enforced during Claude Code skill creation, limiting skill file length. It applies to all skill content governed by the skill developer framework, ensuring skills maintain manageable progressive disclosure workflows.