Command Development

Referentie voor het schrijven van Claude Code slash-commando's: frontmatter, argumenten, bash en bestandsreferenties

Door tzachbon · tzachbon/smart-ralph

Getest · Werkt ★ 9.2/10

Command Development — Referentie voor het schrijven van Claude Code slash-commando's: frontmatter, argumenten, bash en bestandsreferenties

Wat het doet

Een referentie-skill die het schrijven van Claude Code slash-commando's begeleidt: YAML frontmatter-velden (description, argument-hint, allowed-tools, model), dynamische argumenten ($1/$ARGUMENTS), @ bestandsreferenties, inline bash-uitvoering, namespacing en plugin-specifieke patronen. Wordt geactiveerd wanneer de gebruiker vraagt om een slash-commando te maken, commando-argumenten te definiëren, commando-frontmatter te gebruiken of commando's te organiseren. Omvat zowel project-/persoonlijke commando's als plugin-gebundelde commando's.

Testrapport

SKILL.md opgehaald via raw GitHub; frontmatter parset met name+description en versie 0.2.0. 3 gekoppelde bestanden gecontroleerd (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — allemaal HTTP 200. Geen beveiligingsrisico's. Voor de outputtest heb ik hetzelfde commando ("fix a GitHub issue by number") twee keer gebouwd: een naïeve baseline en een die de skill-body volgde. Baseline had geen frontmatter, was geschreven als berichten AAN de gebruiker ("Thanks for using this command!") — precies het anti-patroon waar de skill voor waarschuwt — en gebruikte geen argument-tokens (0 voorkomens van $1/$ARGUMENTS), dus het issue-nummer werd nooit geïnjecteerd. De skill-versie voegde scoped frontmatter toe (argument-hint, allowed-tools: Bash(gh:*)), injecteerde $1 op 3 plaatsen, gebruikte !`gh issue view $1` voor context, en behandelde het ontbrekende-argument-geval. Trigger-oordeel: 3 commando-auteur-fraseringen laden het, 2 aangrenzende ("create a new PDF-parsing skill", "write a git commit message") doen dat correct niet.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

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.

Commando's en voorbeeldprompts

  • /command-developmentReferentie voor het schrijven van Claude Code slash-commando's: frontmatter, argumenten, bash en bestandsreferenties

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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