What is a Claude Code Skill?

A Claude Code Skill is a specialized capability that enhances Claude's behavior during specific tasks by providing domain-specific guidance and implementation patterns.

What are the mandatory files for a new skill?

Every skill requires a SKILL.md file located within its specific subdirectory in the .claude/skills/ folder.

How do I validate a new skill I've created?

You can use the CLI command 'bpsai-pair skill validate {skill-name}' to check for naming, structure, and frontmatter errors.

Why must skill names be in gerund form?

Gerunds (ending in -ing) ensure an action-oriented, consistent naming convention that makes the purpose of every skill immediately clear to both users and the AI.

Skill Creation Standards

Name: Skill Creation Standards
Author: BPSAI

byBPSAI

•

Productivity & Workflow

Orchestrates the development, documentation, and validation of reusable Claude Code skills for standardized workflows.

About

The Skill Creation Standards skill provides a comprehensive framework for defining, naming, and validating custom Claude Code capabilities. It enforces a strict directory structure and frontmatter schema, enabling teams to transform complex multi-step processes into reusable, error-resistant automation patterns that enhance Claude's performance across diverse development environments using the bpsai-pair toolset.

Key Features

Frontmatter schema verification for metadata accuracy
Workflow documentation patterns for multi-step processes
Automated skill validation via CLI commands
Strict naming convention enforcement using gerund forms
Standardized SKILL.md template generation
2 GitHub stars

Use Cases

Scaling custom AI capabilities across large engineering organizations
Automating complex, repetitive multi-step development tasks
Standardizing internal team workflows and documentation practices

About

Key Features

Frontmatter schema verification for metadata accuracy
Workflow documentation patterns for multi-step processes
Automated skill validation via CLI commands
Strict naming convention enforcement using gerund forms
Standardized SKILL.md template generation
2 GitHub stars

Use Cases

Scaling custom AI capabilities across large engineering organizations
Automating complex, repetitive multi-step development tasks
Standardizing internal team workflows and documentation practices