Command Development

Create Claude Code slash commands with frontmatter, arguments, and bash execution.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/valeratrades/plugin-dev --skill command-development-valeratrades
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Command Development
Source: https://github.com/valeratrades/plugin-dev/tree/main/skills/command-development
Command: npx skills add https://github.com/valeratrades/plugin-dev --skill command-development-valeratrades

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building reusable slash commands for Claude Code requires knowing the Markdown file format, YAML frontmatter fields, dynamic argument syntax, and plugin integration patterns, which are easy to get wrong without structured guidance. ## Core Features & Use Cases - Command Fundamentals: Covers file locations, Markdown structure, and YAML frontmatter fields like description, allowed-tools, model, and argument-hint. - Dynamic Features: Explains $ARGUMENTS and positional arguments, @ file references, and inline bash execution for context-aware commands. - Plugin Integration: Documents ${CLAUDE_PLUGIN_ROOT} usage, command namespacing, and coordination with agents, skills, and hooks. - Use Case: When you need a /review-pr command that fetches a pull request via gh CLI, validates the PR number argument, and launches a code-reviewer agent, this Skill provides the exact frontmatter and prompt patterns to build it. ## Quick Start Ask Claude to create a slash command that reviews a pull request by number using the gh CLI and positional arguments.

Frequently Asked Questions about Command Development

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

FAQPage Schema
How do I create a slash command in Claude Code?▼

Create a Markdown file in .claude/commands/ for project commands or ~/.claude/commands/ for personal commands. Write the prompt as instructions for Claude, optionally adding YAML frontmatter with a description field so it appears in /help.

How to use arguments in Claude Code slash commands?▼

Use $ARGUMENTS to capture all arguments as one string, or $1, $2, $3 for positional arguments. Document expected arguments with the argument-hint frontmatter field so users see them in autocomplete.

What frontmatter fields do Claude Code commands support?▼

Commands support description, allowed-tools, model (sonnet, opus, haiku), argument-hint, and disable-model-invocation. All fields are optional, and commands work without any frontmatter at all.

Can slash commands run bash commands in Claude Code?▼

Yes, commands can execute bash inline to gather context like git status before Claude processes the prompt. The command must include Bash in its allowed-tools frontmatter, ideally scoped with filters like Bash(git:*).

Why is my slash command not appearing in Claude Code?▼

Check that the file is in the correct commands directory, has a .md extension, and contains valid Markdown. Restart Claude Code after adding the file, and verify any YAML frontmatter has no syntax errors.

When should I use AskUserQuestion instead of command arguments?▼

Use AskUserQuestion for multiple-choice decisions needing explanation, multi-select scenarios, or interactive workflows. Use plain arguments for simple known values like file paths, numbers, or names that should stay scriptable.