How do I validate my skill configuration?

You can use the 'yarn lint:skill' command to check for JSON syntax errors, missing SKILL.md files, and invalid trigger configurations.

How do I debug skill activation issues?

You can run commands with the SKILL_DEBUG=true environment variable to see detailed matching logic and stderr output explaining why a skill did or did not trigger.

What is the difference between keyword and intent triggers?

Keywords use exact substring matching for specific topics, while intent patterns use regex to identify the implicit action or goal a user wants to achieve.

What is the role of the UserPromptSubmit hook?

This hook runs before Claude sees the user's prompt, injecting formatted reminders or skill context based on the detected intent to guide the model's behavior proactively.

What is the 500-line rule for Claude skills?

It is an Anthropic best practice stating that SKILL.md files should be kept under 500 lines to maintain context efficiency and model focus, using reference files for deeper details.

Claude Code Skill Development Guide

Name: Claude Code Skill Development Guide
Author: Microck

byMicrock

•

Learning & Documentation

Provides comprehensive technical guidance for creating, managing, and debugging auto-activating Claude Code skills following Anthropic's architectural patterns.

About

This skill serves as a meta-guide for developers looking to extend Claude Code's capabilities through specialized domain skills and custom hooks. It streamlines the creation process by enforcing Anthropic's best practices, such as the 500-line rule and progressive disclosure patterns, while offering deep technical insights into YAML frontmatter, regex-based intent matching, and the UserPromptSubmit hook system. Whether you are architecting a complex domain-specific utility or troubleshooting skill activation logic in skill-rules.json, this resource provides the templates and validation steps necessary to build efficient, high-performance AI coding extensions.

Key Features

81 GitHub stars
Regex-based intent pattern matching and keyword triggers
Automated skill activation and hook logic documentation
Schema validation for skill-rules.json configuration files
Comprehensive debugging workflows using SKILL_DEBUG variables
Anthropic 500-line rule enforcement for context efficiency

Use Cases

Debugging skill activation and hook system failures
Implementing progressive disclosure for large documentation sets
Architecting new domain-specific Claude Code skills

About

Key Features

81 GitHub stars
Regex-based intent pattern matching and keyword triggers
Automated skill activation and hook logic documentation
Schema validation for skill-rules.json configuration files
Comprehensive debugging workflows using SKILL_DEBUG variables
Anthropic 500-line rule enforcement for context efficiency

Use Cases

Debugging skill activation and hook system failures
Implementing progressive disclosure for large documentation sets
Architecting new domain-specific Claude Code skills