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.

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

0181 GitHub stars

02Regex-based intent pattern matching and keyword triggers

03Automated skill activation and hook logic documentation

04Schema validation for skill-rules.json configuration files

05Comprehensive debugging workflows using SKILL_DEBUG variables

06Anthropic 500-line rule enforcement for context efficiency

Use Cases

01Debugging skill activation and hook system failures

02Implementing progressive disclosure for large documentation sets

03Architecting new domain-specific Claude Code skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add microck/ordinary-claude-skills writing-skills

For use in Claude.ai and ChatGPT

Download Skill