Command Development

Référence pour la création de commandes slash Claude Code : frontmatter, arguments, références bash et de fichiers

par tzachbon · tzachbon/smart-ralph

Testé · Fonctionne ★ 9.2/10

Command Development — Référence pour la création de commandes slash Claude Code : frontmatter, arguments, références bash et de fichiers

Ce que fait

Une compétence de référence qui guide la création de commandes slash Claude Code : champs de frontmatter YAML (description, argument-hint, allowed-tools, model), arguments dynamiques ($1/$ARGUMENTS), références de fichiers @, exécution bash en ligne, gestion des espaces de noms et modèles spécifiques aux plugins. Se déclenche lorsque l'utilisateur demande de créer une commande slash, de définir des arguments de commande, d'utiliser le frontmatter de commande ou d'organiser des commandes. Couvre à la fois les commandes de projet/personnelles et les commandes intégrées aux plugins.

Rapport de test

SKILL.md a été récupéré via raw GitHub ; le frontmatter est analysé avec name+description et la version 0.2.0. Vérification ponctuelle de 3 fichiers liés (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — tous HTTP 200. Pas de failles de sécurité. Pour le test de sortie, j'ai construit la même commande ("fix a GitHub issue by number") deux fois : une version de base naïve et une suivant le corps de la compétence. La version de base n'avait pas de frontmatter, était écrite comme des messages À l'utilisateur ("Thanks for using this command!") — l'anti-pattern exact contre lequel la compétence met en garde — et n'utilisait aucun token d'argument (0 occurrences de $1/$ARGUMENTS), donc le numéro de l'issue n'a jamais été injecté. La version de la compétence a ajouté un frontmatter scopé (argument-hint, allowed-tools: Bash(gh:*)), a injecté $1 à 3 endroits, a utilisé !`gh issue view $1` pour le contexte, et a géré le cas de l'argument manquant. Jugement de déclenchement : 3 formulations d'auteur de commande le chargent, 2 adjacentes ("create a new PDF-parsing skill", "write a git commit message") ne le font pas correctement.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Commandes et exemples de prompts

  • /command-developmentRéférence pour la création de commandes slash Claude Code : frontmatter, arguments, références bash et de fichiers

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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