Command Development

Referenz für das Erstellen von Claude Code Slash-Befehlen: Frontmatter, Argumente, Bash und Dateireferenzen

von tzachbon · tzachbon/smart-ralph

Getestet · Funktioniert ★ 9.2/10

Command Development — Referenz für das Erstellen von Claude Code Slash-Befehlen: Frontmatter, Argumente, Bash und Dateireferenzen

Was es kann

Eine Referenz-Fähigkeit, die das Erstellen von Claude Code Slash-Befehlen anleitet: YAML Frontmatter-Felder (description, argument-hint, allowed-tools, model), dynamische Argumente ($1/$ARGUMENTS), @ Dateireferenzen, Inline-Bash-Ausführung, Namespacing und Plugin-spezifische Muster. Wird ausgelöst, wenn der Benutzer einen Slash-Befehl erstellen, Befehlsargumente definieren, Befehls-Frontmatter verwenden oder Befehle organisieren möchte. Umfasst sowohl Projekt-/persönliche Befehle als auch Plugin-gebündelte Befehle.

Testbericht

SKILL.md über raw GitHub abgerufen; Frontmatter wird mit name+description und Version 0.2.0 geparst. 3 verknüpfte Dateien (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) stichprobenartig überprüft – alle HTTP 200. Keine Sicherheitsmängel. Für den Ausgabetest habe ich denselben Befehl ("fix a GitHub issue by number") zweimal erstellt: eine naive Baseline und eine, die dem Skill-Körper folgt. Die Baseline hatte kein Frontmatter, war als Nachrichten AN den Benutzer geschrieben ("Thanks for using this command!") – genau das Anti-Muster, vor dem der Skill warnt – und verwendete keine Argument-Tokens (0 Vorkommen von $1/$ARGUMENTS), sodass die Issue-Nummer nie injiziert wurde. Die Skill-Version fügte scoped Frontmatter hinzu (argument-hint, allowed-tools: Bash(gh:*)), injizierte $1 an 3 Stellen, verwendete !`gh issue view $1` für den Kontext und behandelte den Fall fehlender Argumente. Trigger-Beurteilung: 3 Befehls-Authoring-Phrasen laden es, 2 angrenzende ("create a new PDF-parsing skill", "write a git commit message") tun dies korrekt nicht.

Getestet am: 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.

Befehle & Beispiel-Prompts

  • /command-developmentReferenz für das Erstellen von Claude Code Slash-Befehlen: Frontmatter, Argumente, Bash und Dateireferenzen

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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