Command Development

Riferimento per la creazione di comandi slash di Claude Code: frontmatter, argomenti, bash e riferimenti a file

di tzachbon · tzachbon/smart-ralph

Promosso ★ 9.2/10

Command Development — Riferimento per la creazione di comandi slash di Claude Code: frontmatter, argomenti, bash e riferimenti a file

Cosa fa

Una skill di riferimento che guida la creazione di comandi slash di Claude Code: campi frontmatter YAML (description, argument-hint, allowed-tools, model), argomenti dinamici ($1/$ARGUMENTS), riferimenti a file @, esecuzione bash inline, namespacing e pattern specifici dei plugin. Si attiva quando l'utente chiede di creare un comando slash, definire argomenti di comando, usare il frontmatter del comando o organizzare i comandi. Copre sia i comandi di progetto/personali che i comandi inclusi nei plugin.

Rapporto di test

SKILL.md recuperato tramite raw GitHub; il frontmatter viene analizzato con name+description e versione 0.2.0. Verificati 3 file collegati (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — tutti HTTP 200. Nessun problema di sicurezza. Per il test di output ho costruito lo stesso comando ("fix a GitHub issue by number") due volte: una baseline ingenua e una seguendo il corpo della skill. La baseline non aveva frontmatter, era scritta come messaggi ALL'utente ("Thanks for using this command!") — l'esatto anti-pattern contro cui la skill avverte — e non usava token di argomento (0 occorrenze di $1/$ARGUMENTS), quindi il numero del problema non è mai stato iniettato. La versione della skill ha aggiunto un frontmatter scoped (argument-hint, allowed-tools: Bash(gh:*)), ha iniettato $1 in 3 punti, ha usato !`gh issue view $1` per il contesto e ha gestito il caso dell'argomento mancante. Giudizio trigger: 3 frasi di authoring di comando la caricano, 2 adiacenti ("create a new PDF-parsing skill", "write a git commit message") correttamente no.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /command-developmentRiferimento per la creazione di comandi slash di Claude Code: frontmatter, argomenti, bash e riferimenti a file

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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