Command Development

Referencia para la creación de comandos slash de Claude Code: frontmatter, argumentos, referencias bash y de archivos

Por tzachbon · tzachbon/smart-ralph

Probado · Funciona ★ 9.2/10

Command Development — Referencia para la creación de comandos slash de Claude Code: frontmatter, argumentos, referencias bash y de archivos

Qué hace

Una habilidad de referencia que guía la creación de comandos slash de Claude Code: campos de frontmatter YAML (description, argument-hint, allowed-tools, model), argumentos dinámicos ($1/$ARGUMENTS), referencias de archivos @, ejecución de bash en línea, espacios de nombres y patrones específicos de plugins. Se activa cuando el usuario pide crear un comando slash, definir argumentos de comando, usar frontmatter de comando u organizar comandos. Cubre tanto comandos de proyecto/personales como comandos incluidos en plugins.

Informe de la prueba

SKILL.md obtenido vía raw GitHub; el frontmatter se analiza con name+description y versión 0.2.0. Se verificaron 3 archivos vinculados (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — todos HTTP 200. Sin problemas de seguridad. Para la prueba de salida, construí el mismo comando ("fix a GitHub issue by number") dos veces: una línea base ingenua y una siguiendo el cuerpo de la habilidad. La línea base no tenía frontmatter, estaba escrita como mensajes PARA el usuario ("Thanks for using this command!") — el anti-patrón exacto contra el que advierte la habilidad — y no usaba tokens de argumento (0 ocurrencias de $1/$ARGUMENTS), por lo que el número de problema nunca fue inyectado. La versión de la habilidad añadió frontmatter con ámbito (argument-hint, allowed-tools: Bash(gh:*)), inyectó $1 en 3 lugares, usó !`gh issue view $1` para el contexto y manejó el caso de argumento faltante. Juicio de activación: 3 frases de autoría de comandos lo cargan, 2 adyacentes ("create a new PDF-parsing skill", "write a git commit message") no lo hacen correctamente.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/tzachbon/smart-ralph.git /tmp/command-development-src
mkdir -p ~/.claude/skills
cp -R "/tmp/command-development-src/.agents/skills/Command Development" ~/.claude/skills/command-development
# SKILL.md lands at ~/.claude/skills/command-development/SKILL.md
# Pure documentation skill — no deps, no scripts, no API keys.
# Bundles references/ and examples/ subdirs the SKILL.md links to.

Comandos y prompts de ejemplo

  • /command-developmentReferencia para la creación de comandos slash de Claude Code: frontmatter, argumentos, referencias bash y de archivos

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Create a slash command with custom arguments
  • Add file references to this command
  • Use AskUserQuestion inside my new command