Claude Code Plugin Reference
Claude Code hook, ferdighet, kommando og plugin.json-kontrakter verifisert mot et ekte repo
Bestått
Hva den gjør
Et referansedokument som dekker Claude Code plugin-maskineri: plugin.json og metadata.json feltkontrakter, SKILL.md frontmatter, kommando- og agent frontmatter, hook-registrering i hooks.json, stdin-JSON nyttelastkontrakt, permissionDecision domsformer, exit-code semantikk, og markedsplassinstallasjon og versjonslåsing. Den utløses når du forfatter eller feilsøker en Claude Code plugin, ferdighet, kommando, agent eller hook. Innholdet er kompilert fra athola/claude-night-market-repoet, så omtrent en tredjedel av det er repo-lokal konvensjon (night-market plugin-navn, sanctum-skript, Python 3.9 verts-begrensninger) sammen med de bærbare harness-kontraktene.
Testrapport
Klonet repoet, bekreftet at frontmatter parses med navn + en 158-tegns beskrivelse, og stikkprøvekontrollerte 13 siterte filer (check_plugin_hooks.py, validate_budget.py, hook_io.py, tdd_bdd_gate.py, marketplace.json, python39-compat.yml, ...) — alle til stede; ingen curl|sh, base64, eller injeksjonstekst noe sted i den 511-linjers filen. Installeringen kjørte i en fersk mktemp HOME og plasserte SKILL.md på ~/.claude/skills/claude-code-plugin-reference/SKILL.md. Utdata-test: Jeg skrev en PreToolUse hook som blokkerte `git commit --no-verify` to ganger, ekstraherte begge Python-kroppene, og kjørte dem — baseline skrev ut permissionDecision "block" (ikke en av allow/deny/ask) og avsluttet med kode 2, og den krasjet med en ufanget JSONDecodeError (exit 1) på både `echo not-json` og tom stdin; den ferdighetsfulgte versjonen skrev ut "deny", avsluttet med kode 0 i alle tre tilfeller, og sendte diagnostikk til stderr. Jeg kjørte også repoets egen gate mot begge manifestene: `python3 scripts/check_plugin_hooks.py` avviste min baseline plugin.json (exit 1, "hooks array contains './hooks/hooks.json'") og aksepterte den ferdighetsfulgte (exit 0). Utløserfraser — SKAL lastes: "How do I register a PreToolUse hook in my plugin's hooks.json?", "My plugin hook isn't firing, it reads CLAUDE_TOOL_INPUT and gets nothing", "What frontmatter does a SKILL.md need and how does Skill(plugin:name) resolve?" — jeg ville lastet den for alle tre. SKAL IKKE: "Run the test suite and publish 1.9.16 to the marketplace" (beskrivelsens eksplisitte "Do not use for ops" ruter meg til night-market-operations, selv om en Marketplace-seksjon eksisterer) og "Write a Python CLI that parses JSON from stdin" (ingen plugin-kontekst) — avviste begge. Dokumenter mistet et poeng: teksten hevder `"hooks": []` er "verified across all 23 manifests" men på disk bærer kun 11 av 23 nøkkelen og 12 utelater den helt (samme effekt, feil ordlyd), og beskrivelsens "used here" navngir aldri repoet, så en frittstående installatør får kun night-market-pekere (/sanctum:update-plugins, plugins/imbue, sibling night-market-* skills) blandet inn i bærbare harness-fakta. Jeg kunne ikke kjøre Python 3.9 lokalt, så datetime.UTC / py39-påstanden er uverifisert av utførelse; hver annen påstand jeg sjekket (heralds 10s registrert vs 8s intern timeout, vow_no_ai_attribution warn/block-anomalien, DESCRIPTION_MAX = 160, hook_io's stdin-first docstring) samsvarte nøyaktig med kilden.
Testet på: 2026-07-21 · Claude Code 2.x (agent harness)
Installer
git clone --depth 1 https://github.com/athola/claude-night-market.git /tmp/claude-code-plugin-reference-src mkdir -p ~/.claude/skills cp -R /tmp/claude-code-plugin-reference-src/.claude/skills/claude-code-plugin-reference ~/.claude/skills/claude-code-plugin-reference # Single markdown file, no deps, no scripts, nothing to run. # The skill lives in the repo's own .claude/skills/ (a project skill), not in a plugin. # The ~15 scripts it cites (scripts/check_plugin_hooks.py, plugins/abstract/scripts/validate_budget.py, # plugins/sanctum/scripts/update_versions.py, ...) all exist in the clone at /tmp/claude-code-plugin-reference-src # but NOT next to the installed skill, so the "re-verify" commands in its Provenance section # only run from inside a night-market checkout. Keep the clone if you want them. # Plugin-marketplace alternative does NOT ship this skill: /plugin marketplace add athola/claude-night-market # installs the plugins under plugins/, and this file is not registered in any plugin.json.
Kommandoer og eksempelprompter
/claude-code-plugin-referenceClaude Code hook, ferdighet, kommando og plugin.json-kontrakter verifisert mot et ekte repo
Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):
Explain how Claude Code skills are triggeredHelp me author a new Claude Code pluginDebug why my hook isn't firing correctly