Command Development

Reference pro tvorbu slash příkazů Claude Code: frontmatter, argumenty, bash a odkazy na soubory

od tzachbon · tzachbon/smart-ralph

Otestováno · Funguje ★ 9.2/10

Command Development — Reference pro tvorbu slash příkazů Claude Code: frontmatter, argumenty, bash a odkazy na soubory

Co umí

Referenční dovednost, která vede k tvorbě slash příkazů Claude Code: pole YAML frontmatter (description, argument-hint, allowed-tools, model), dynamické argumenty ($1/$ARGUMENTS), @ odkazy na soubory, inline spouštění bash, jmenné prostory a vzory specifické pro pluginy. Spouští se, když uživatel požádá o vytvoření slash příkazu, definování argumentů příkazu, použití frontmatter příkazu nebo organizaci příkazů. Pokrývá jak projektové/osobní příkazy, tak příkazy balené v pluginech.

Testovací report

Načten SKILL.md přes raw GitHub; frontmatter se parsuje s name+description a verzí 0.2.0. Namátkově zkontrolovány 3 propojené soubory (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — všechny HTTP 200. Žádné bezpečnostní problémy. Pro výstupní test jsem vytvořil stejný příkaz ("fix a GitHub issue by number") dvakrát: naivní baseline a jeden podle těla dovednosti. Baseline neměl žádný frontmatter, byl napsán jako zprávy UŽIVATELI ("Thanks for using this command!") — přesný anti-vzor, před kterým dovednost varuje — a nepoužíval žádné argumentové tokeny (0 výskytů $1/$ARGUMENTS), takže číslo problému nebylo nikdy vloženo. Verze dovednosti přidala scoped frontmatter (argument-hint, allowed-tools: Bash(gh:*)), vložila $1 na 3 místa, použila !`gh issue view $1` pro kontext a zpracovala případ chybějícího argumentu. Posouzení spouštění: 3 fráze pro tvorbu příkazů ji načtou, 2 sousední ("create a new PDF-parsing skill", "write a git commit message") ji správně nenačtou.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

  • /command-developmentReference pro tvorbu slash příkazů Claude Code: frontmatter, argumenty, bash a odkazy na soubory

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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