command-spec

Define command specifications for Claude Code plugins with YAML frontmatter.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/biwakonbu/cc-plugins --skill command-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: command-spec
Source: https://github.com/biwakonbu/cc-plugins/tree/main/plugins/plugin-generator/skills/command-spec
Command: npx skills add https://github.com/biwakonbu/cc-plugins --skill command-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill defines the correct command specification for Claude Code plugins, including slash commands and YAML frontmatter.

Core Features & Use Cases

  • Understand slash command structure and frontmatter requirements
  • Validate command documentation and file layout at commands/{command-name}.md
  • Provide guidance for model and argument handling, validation of fields
  • Use case: When creating or updating a command, ensure the presence of a description and proper metadata

Quick Start

Use this skill when creating a new slash command file by placing it under commands/{command-name}.md with a frontmatter describing the command, its variables, and the invocation pattern.

Frequently Asked Questions about command-spec

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

FAQPage Schema
How do I create a slash command for a Claude Code plugin?

Slash commands in Claude Code plugins require a markdown file placed at commands/{command-name}.md with YAML frontmatter that defines the description, optional model, variables, and invocation syntax.

What frontmatter fields are required for Claude Code plugin commands?

The required frontmatter field for Claude Code plugin commands is description, while the model field is optional, both ensuring accurate metadata and proper command invocation syntax.

How do I validate command file layout and naming in a Claude Code plugin?

To validate command file layout in a Claude Code plugin, ensure files are named correctly and placed strictly under the commands/{command-name}.md path with proper frontmatter fields.

Can I specify a model for individual slash commands in Claude Code?

Yes, you can specify a model for individual slash commands in Claude Code plugins by including the optional model field in the YAML frontmatter alongside the required description field.

What is the correct file placement for Claude Code plugin slash commands?

Claude Code plugin slash commands must be placed under the commands/ directory using the commands/{command-name}.md naming convention to ensure proper invocation and validation.

Why is my Claude Code plugin command not validating correctly?

Claude Code plugin commands fail validation if the file is not placed at commands/{command-name}.md or if the YAML frontmatter lacks the required description field or accurate metadata.