managing-slash-commands

Create, analyze, update, and improve slash commands with YAML frontmatter and arguments.

Updated Nov 26, 2025
One-click install
npx skills add https://github.com/thoeltig/claude-code-toolkit --skill managing-slash-commands
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: managing-slash-commands
Source: https://github.com/thoeltig/claude-code-toolkit/tree/main/plugins/claude-code-capabilities/skills/managing-slash-commands
Command: npx skills add https://github.com/thoeltig/claude-code-toolkit --skill managing-slash-commands

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Slash commands provide a direct interface for structured prompts and automation. This Skill helps design, document, and optimize slash commands, including argument handling, frontmatter metadata, and plugin/MCP command ecosystems.

Core Features & Use Cases

  • Create slash commands with proper frontmatter and arguments
  • Document plugin commands and MCP commands
  • Manage command namespaces and disambiguation
  • Provide best-practice patterns for SlashCommand usage

Quick Start

Create a new slash command named "status" with description and argument hints; validate with /help and test with /status.

Frequently Asked Questions about managing-slash-commands

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

FAQPage Schema
How do I create a slash command with proper frontmatter and arguments?

Slash commands require YAML frontmatter defining metadata, description, and argument schemas, plus execution logic. Design frontmatter to declare allowed tools, optional models, and validation steps, then structure arguments as named parameters with type hints and help text for Claude to invoke correctly.

What is the difference between slash commands, plugins, and MCP commands?

Slash commands are direct Claude interfaces with frontmatter and arguments for structured prompts. Plugins and MCP commands extend Claude's capabilities through broader ecosystems. This Skill helps you design and document all three, managing namespaces to avoid conflicts across command types.

How do I validate and test a new slash command before deploying?

Use /help to validate frontmatter syntax and argument definitions, then test with /command-name to confirm execution workflows. Check that allowed-tools restrictions, argument parsing, and model selection work as designed before full deployment.

Can I convert an existing prompt into a slash command?

Yes. Extract the core task, structure inputs as named arguments with type hints, define frontmatter metadata including description and tools, and validate against best-practices. This Skill guides you through prompt-to-command conversion and alignment with creation guidelines.

What are best practices for slash command argument handling and namespacing?

Use clear, scoped argument names to prevent ambiguity. Apply namespace prefixes for command families, enforce allowed-tools restrictions to limit scope, and document optional parameters. Follow patterns validated against the creation guide to maintain consistency across your command ecosystem.

Why should slash commands enforce allowed-tools restrictions?

Allowed-tools restrictions limit which capabilities a command can invoke, reducing surface area and improving safety. They ensure commands stay focused on their intended task and prevent accidental misuse of powerful tools outside their scope.