skill-developer

Automate creation, governance, and enforcement of Claude Code skills.

Updated Nov 6, 2025
One-click install
npx skills add https://github.com/Manuelvillarvieites/local-studios-website --skill skill-developer-manuelvillarvieites
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-developer
Source: https://github.com/Manuelvillarvieites/local-studios-website/tree/main/.claude/skills/skill-developer
Command: npx skills add https://github.com/Manuelvillarvieites/local-studios-website --skill skill-developer-manuelvillarvieites

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Developing effective Claude Code skills requires deep knowledge of trigger mechanisms, best practices, and debugging. This skill provides comprehensive guidance to streamline skill creation, ensuring your custom skills are robust, efficient, and adhere to Anthropic's guidelines, ultimately saving you development and debugging time.

Core Features & Use Cases

  • Skill Creation & Management: Guides you through creating new skills, defining triggers (keywords, intent, file paths, content), and setting enforcement levels (block, suggest, warn).
  • Hook Mechanism Deep Dive: Explains how UserPromptSubmit (proactive suggestions) and PreToolUse (critical guardrails) hooks work internally.
  • Best Practices & Troubleshooting: Ensures skills follow the "500-line rule," progressive disclosure, and provides a checklist for debugging activation issues.
  • Use Case: "I need to create a new skill that suggests best practices when I'm working on database migrations. How do I set up the triggers and enforcement to ensure it activates correctly?"

Quick Start

Explain how to create a new skill that triggers when I mention "new feature development" in my prompt.

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 triggers on specific keywords or intent patterns?

Define triggers in skill-rules.json using keywords, intent patterns, file paths, or content patterns. Set enforcement levels (block, suggest, warn) to control how the skill responds when activated. The skill automatically monitors UserPromptSubmit and PreToolUse hooks to enforce your rules.

What's the difference between UserPromptSubmit and PreToolUse hooks in skill development?

UserPromptSubmit provides proactive suggestions during prompt entry, while PreToolUse enforces critical guardrails before tool execution. Choose UserPromptSubmit for advisory workflows and PreToolUse for mandatory enforcement.

How do I debug a Claude Code skill that isn't activating when expected?

Check trigger definitions against your actual prompts and file content. Verify enforcement levels are set correctly and review session tracking in skill-rules.json. Use the provided debugging checklist to validate keyword matches and progressive disclosure rules.

What are best practices for designing Claude Code skills that stay maintainable?

Follow the 500-line rule for skill complexity, use progressive disclosure to avoid overwhelming users, and structure rules with clear frontmatter and role-based patterns. Document enforcement intent and test across trigger scenarios before deployment.

Can I use Claude Code skills to enforce governance policies across my workflow?

Yes. Skills support block, suggest, and warn enforcement levels within skill-rules.json. Block prevents actions, suggest offers guidance, and warn alerts without stopping execution, allowing flexible governance across skill development and usage patterns.

What does the skill-rules.json framework cover for skill governance?

skill-rules.json manages trigger design, hook mechanisms, session tracking, and enforcement policies. It supports structured rule schemas, role-based patterns, and frontmatter configuration for comprehensive skill governance and automated enforcement.