Why is my skill not triggering automatically?

Claude uses pure language reasoning to match user intent to skill descriptions. Ensure your description is action-oriented and clearly states the specific use cases and triggers.

What are the required fields for a Claude Code skill?

Every skill must have a 'name' (max 64 chars) and a 'description' (max 1024 chars) in the YAML frontmatter to be correctly discovered and invoked by Claude.

What does the {baseDir} variable do?

The {baseDir} variable is a template placeholder that resolves to the skill's installation directory, ensuring that your path references remain portable across different systems.

How do I secure my skill's tool access?

Use the 'allowed-tools' field in the frontmatter to define granular permissions, such as 'Bash(git:*)', which limits execution to specific command patterns.

Skills Architecture Expert

Name: Skills Architecture Expert
Author: intent-solutions-io

byintent-solutions-io

Developer Tools

Provides expert guidance on building, debugging, and optimizing Claude Code skills and YAML frontmatter.

About

The Skills Architecture Expert is a specialized tool designed to help developers master the creation and maintenance of Claude Code skills. It offers deep insights into skill discovery mechanisms, YAML frontmatter validation, and granular tool permission scoping. Whether you are troubleshooting why a skill won't trigger or looking to optimize descriptions for better LLM invocation, this skill ensures your custom extensions follow best practices for security, portability, and performance.

Key Features

Validates YAML frontmatter syntax and required discovery fields
Provides guidance on granular tool permission scoping and security
Troubleshoots skill discovery and natural language trigger issues
Explains the three-stage skill execution pipeline and architecture
Optimizes skill descriptions to improve LLM selection accuracy
0 GitHub stars

Use Cases

Auditing existing skills for minimal tool permissions and security compliance
Debugging 'skill not loading' errors or frontmatter configuration issues
Developing and validating new custom skills for Claude Code environments

About

Key Features

Validates YAML frontmatter syntax and required discovery fields
Provides guidance on granular tool permission scoping and security
Troubleshoots skill discovery and natural language trigger issues
Explains the three-stage skill execution pipeline and architecture
Optimizes skill descriptions to improve LLM selection accuracy
0 GitHub stars

Use Cases

Auditing existing skills for minimal tool permissions and security compliance
Debugging 'skill not loading' errors or frontmatter configuration issues
Developing and validating new custom skills for Claude Code environments