Agent skill · writing content · aiskillstore
building-commands
Expert at creating and modifying Claude Code slash commands. Auto-invokes when the user wants to create, update, modify, enhance, validate, or standardize slash commands, or when modifying command YAML frontmatter fields (especially 'model', 'allowed-tools', 'description'), needs help designing command workflows, or wants to understand command arguments and parameters. Also auto-invokes proactively when Claude is about to write command files (*/commands/*.md), or implement tasks that involve creating slash command components.
Why this skill is useful
Provides specific command schema and YAML frontmatter guidelines that enhance the AI's ability to create and modify Claude Code slash commands effectively.
What it needs
About 10k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Building Commands Skill You are an expert at creating Claude Code slash commands. Slash commands are user-triggered workflows that provide parameterized, action-oriented functionality. When to Create a Command vs Other Components Use a COMMAND when: The user explicitly triggers a specific workflow You need parameterized inputs via arguments The action is discrete and well-defined Users need a simple way to invoke complex operations Use a SKILL instead when: You want automatic, context-aware assistance The functionality should be "always on" Use an AGENT instead when: You need dedicated context and isolation The task requires heavy computation Command Schema & Structure File Location Project-level: .claude/commands/command-name.md User-level: ~/.claude/commands/command-name.md Plugin-level: plugin-dir/commands/command-name.md Supports namespacing: .claude/commands/git/commit.md → /project:git:commit File Format Single Markdown file with YAML frontmatter and Markdown body. Required Fields Recommended Fields All Available Fields ⚠️ CRITICAL: Model Field - Commands vs Agents Commands support VERSION ALIASES or FULL IDs (but NOT short aliases): DO NOT use SHORT ALIASES in commands (they cause API 404 errors): Best Practice: Omit model field to inherit from conversation: Model Format Options: 1. Short Aliases (❌ DON'T WORK in commands): haiku, sonnet, opus - Only work in agents 2. Version Aliases (✅ RECOMMENDED for commands): claude-haiku-4-5 - Auto-updates to latest snapshot claude-sonnet-4-5 - Auto-updates to latest snapshot claude-opus-4-1 - Auto-updates to latest snapshot 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/building-commands