Command Development

Referencja do tworzenia komend slash w Claude Code: frontmatter, argumenty, bash i odniesienia do plików

Autor: tzachbon · tzachbon/smart-ralph

Testowano · Działa ★ 9.2/10

Command Development — Referencja do tworzenia komend slash w Claude Code: frontmatter, argumenty, bash i odniesienia do plików

Co robi ten skill

Umiejętność referencyjna, która prowadzi przez tworzenie komend slash w Claude Code: pola frontmatter YAML (description, argument-hint, allowed-tools, model), dynamiczne argumenty ($1/$ARGUMENTS), odniesienia do plików @, wbudowane wykonywanie bash, przestrzenie nazw i wzorce specyficzne dla wtyczek. Uruchamia się, gdy użytkownik prosi o utworzenie komendy slash, zdefiniowanie argumentów komendy, użycie frontmatter komendy lub organizowanie komend. Obejmuje zarówno komendy projektowe/osobiste, jak i komendy dołączone do wtyczek.

Raport z testu

Pobrano SKILL.md przez raw GitHub; frontmatter parsuje z name+description i wersją 0.2.0. Sprawdzono 3 połączone pliki (references/plugin-features-reference.md, references/frontmatter-reference.md, examples/simple-commands.md) — wszystkie HTTP 200. Brak zagrożeń bezpieczeństwa. Do testu wyjścia zbudowałem tę samą komendę („fix a GitHub issue by number”) dwukrotnie: naiwną wersję bazową i wersję zgodną z treścią umiejętności. Wersja bazowa nie miała frontmatter, była napisana jako wiadomości DO użytkownika („Thanks for using this command!”) — dokładnie anty-wzorzec, przed którym ostrzega umiejętność — i nie używała żadnych tokenów argumentów (0 wystąpień $1/$ARGUMENTS), więc numer problemu nigdy nie został wstrzyknięty. Wersja umiejętności dodała frontmatter z zakresem (argument-hint, allowed-tools: Bash(gh:*)), wstrzyknęła $1 w 3 miejscach, użyła !`gh issue view $1` dla kontekstu i obsłużyła przypadek brakującego argumentu. Ocena wyzwalacza: 3 frazy dotyczące tworzenia komend ładują ją, 2 sąsiednie („create a new PDF-parsing skill”, „write a git commit message”) poprawnie nie ładują.

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

Instalacja

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.

Komendy i przykładowe prompty

  • /command-developmentReferencja do tworzenia komend slash w Claude Code: frontmatter, argumenty, bash i odniesienia do plików

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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