skills.rest
Compass-Brand
Compass-BrandOFFICIAL
Explore all skills by this author →
GitHub

creating-skills

Define standardized Claude Skill units with SKILL.md frontmatter.

Updated Jan 29, 2026
Search Tags:#documentation#validation#discovery#naming-conventions#frontmatter#skill-creation#structure-guidelines
One-click install
npx skills add https://github.com/Compass-Brand/compass-forge --skill creating-skills-compass-brand
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: creating-skills
Source: https://github.com/Compass-Brand/compass-forge/tree/main/.claude/skills/creating-skills-skill
Command: npx skills add https://github.com/Compass-Brand/compass-forge --skill creating-skills-compass-brand

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users to create Claude Skill units that are consistently structured, discoverable, and actionable, reducing ambiguity and improving reuse across projects.

Core Features & Use Cases

  • Enforces a mandatory SKILL.md frontmatter at Skill root, including name and description, to enable reliable discovery.
  • Defines optional directories (scripts/, references/, assets/) for on-demand resources and richer context.
  • Provides clear documentation structure and examples to accelerate skill creation and onboarding.

Quick Start

Examples: Create a new Skill unit by adding a SKILL.md with the required fields and placing any supporting files in optional directories as needed.

Frequently Asked Questions about creating-skills

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

FAQPage Schema
What is a SKILL.md frontmatter and why is it needed for Claude Code skills?▼

A SKILL.md frontmatter is a mandatory metadata block at the skill root containing the name and description fields. It enables reliable discovery, quick scanning, and predictable activation across future conversations.

How do I structure a new Claude Code skill for reliable discovery?▼

To structure a Claude Code skill, create a SKILL.md file with mandatory name and description frontmatter. Add optional scripts/, references/, and assets/ directories for supporting resources to ensure consistent behavior.

Do I need any dependencies to create a Claude Skill unit?▼

No dependencies are required to create a Claude Skill unit. You only need to define a SKILL.md file with the required frontmatter fields and organize optional supporting files into their respective directories.

What is the best way to organize scripts and references when creating skills?▼

The best way to organize resources is placing on-demand scripts in the scripts/ directory, context files in references/, and media in assets/. This structure supports reliable activation and richer context alongside the SKILL.md.

Can I use existing naming conventions when creating a Claude Code skill?▼

Yes, existing naming conventions can be applied, but they must align with the standardized Skill unit structure. The mandatory SKILL.md frontmatter enforces the name and description fields required for the discovery pipeline.

Why does my Claude Skill not activate reliably during conversations?▼

Unreliable skill activation often stems from missing or malformed SKILL.md frontmatter. Enforcing the standardized structure with mandatory name and description fields ensures metadata supports quick scanning and predictable behavior.

Related Skills

Explore More Content & Communication Skills→
pradyumnasagarpradyumnasagar
6

agent-handoff

Automate inter-skill data transfer and provenance capture via JSON Material Passports.

Community
Advanced
Snowflake-LabsSnowflake-Labs
12

read-ors-configuration

A concise summary of your roleplay character: name,</name> personality, and/or behavior, formatted as a single string sentence. Typically不超过50字，此处省略

Official
Intermediate
woocommercewoocommerce
10.5k

woocommerce-code-review

Flag WooCommerce coding-standards violations in PHP code changes.

Official
Basic
caseywdunncaseywdunn
2

dunnlab-new-project

Scaffold new Dunn Lab projects with documentation and environment setup.

Community
Advanced