new-skill

Configure Claude Code skill auto-activation rules across YAML frontmatter and skill-rules.yaml.

47|11|Updated Nov 26, 2025

Search Tags:#Claude Code #YAML #skill-development #frontmatter #progressive-disclosure #hook-mechanisms #skill-triggers

Ready to run

npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill new-skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: new-skill
Source: https://github.com/majesticlabs-dev/majestic-marketplace/tree/main/plugins/majestic-tools/skills/new-skill
Command: npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill new-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill Developer Guide helps teams create and manage Claude Code skills following Anthropic best practices, including the 500-line rule and progressive disclosure.

Core Features & Use Cases

Frontmatter patterns: YAML frontmatter with required fields and trigger keywords.
Trigger patterns: Keywords, intent patterns, file paths, and content patterns.
Enforcement & Hooks: Distinguish triggers from hooks and understands session tracking.
Progressive disclosure: Use reference files to provide detailed guidance without clutter.

Quick Start

Create SKILL.md with frontmatter (name, description) at .claude/skills/{skill-name}/SKILL.md.
Add to .claude/skills/skill-rules.yaml.
Test triggers using provided npx tsx commands and refine patterns.

Frequently Asked Questions about new-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create Claude Code skills with auto-activation triggers?▼

Configure skill auto-activation by adding YAML frontmatter to SKILL.md in `.claude/skills/{skill-name}/`, then register triggers in `.claude/skills/skill-rules.yaml`. Triggers activate skills based on keywords, intent patterns, file paths, or content patterns, enabling progressive disclosure without manual invocation.

What trigger types and enforcement levels does Claude Code skill development support?▼

Claude Code skills support four trigger types—keywords, intent patterns, file paths, and content patterns—with three enforcement levels: block (prevents execution), suggest (recommends the skill), and warn (alerts users). Hooks like UserPromptSubmit and PreToolUse enable session tracking and conditional activation.

How do I structure YAML frontmatter for a Claude Code skill?▼

YAML frontmatter requires name and description fields at minimum. Place it at the top of SKILL.md, define trigger keywords and patterns, set enforcement level, and optionally specify hooks. This frontmatter configures which conditions activate your skill during Claude Code sessions.

What's the 500-line rule for Claude Code skill development?▼

The 500-line rule limits skill implementation scope to promote modularity and maintainability. Reference files provide detailed guidance without adding bulk, keeping core skill logic concise while supporting progressive disclosure of advanced features and configuration options.

Can I use progressive disclosure to organize complex skill documentation?▼

Yes. Progressive disclosure uses reference files to surface essential information first while hiding detailed guidance. This keeps the main skill concise, follows the 500-line rule, and lets users access advanced patterns and examples through structured references without overwhelming the base skill file.

How do I test and refine skill triggers during development?▼

Test triggers using provided npx tsx commands to validate keyword matching, intent patterns, file path detection, and content pattern recognition. Refine patterns iteratively based on test results, then update SKILL.md frontmatter and skill-rules.yaml to deploy your trigger configuration.