CtrlK
BlogDocsLog inGet started
Tessl Logo

claude-hook-writer

Expert guidance for writing secure, reliable, and performant Claude Code hooks - validates design decisions, enforces best practices, and prevents common pitfalls. Use when creating, reviewing, or debugging Claude Code hooks.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is action-dense with executable bash throughout and a well-sequenced design checklist plus final checklist. Its main gaps are minor repeat padding of the same reference pointers and one broken reference path (`references/hook-templates.md`) at line 259.

Suggestions

Fix the dangling reference at line 259: `references/hook-templates.md` does not exist — either add the file or point to the real `references/code-templates.md` / `quick-reference.md`.

De-duplicate the 'Load references/...' callouts: security-requirements.md and reliability-performance.md are each pointed to 3+ times; consolidate to a single navigation pointer per topic.

Tighten the repeated 'Why this matters' paragraphs under each Pitfall, which restate information already implied by the example, to improve token efficiency.

DimensionReasoningScore

Conciseness

The body is largely lean — bash snippets like `FILE=$(echo "$INPUT" | jq -r '.input.file_path // empty')` earn their tokens, and concepts are not over-explained. Minor over-explanation remains in repeated 'Why this matters' callouts and redundant 'For ... patterns: Load references/...' pointers (security/perf refs appear 3+ times each). Not a 5 due to this repeat padding; not a 3 because the bulk is efficient and assumes Claude's competence.

4 / 5

Actionability

Quote: `prettier --write "$FILE"`, `if command -v prettier &>/dev/null`, and the validated `rm` path with `[[ "$FILE" == "$CLAUDE_PROJECT_DIR"* ]]` checks — fully executable, copy-paste ready bash covering common cases (quoting, validation, backgrounding, exit codes). Matches anchor 5 'fully executable; copy-paste ready code'.

5 / 5

Workflow Clarity

The 'Hook Design Checklist' sequences decisions (event → matcher → input → type → exit code) and the 'Final Checklist' plus 'Critical Rules' provide explicit checkpoints. Validation guidance (validate before use, exit 2 to block) is present. Not a 5 because there is no explicit validate→fix→retry feedback loop narrative for destructive hook actions, and not a 3 because most checkpoints are explicit and concrete.

4 / 5

Progressive Disclosure

Six real reference files (security-requirements.md, reliability-performance.md, code-templates.md, testing-debugging.md, publishing-guide.md, quick-reference.md — all verified present) are clearly signaled via a dedicated 'When to Load References' section with load triggers, one level deep. However line 259 references `references/hook-templates.md`, which does NOT exist in the bundle — a broken navigation pointer. Not a 5 due to that dangling reference; not a 3 because the overall structure is well-organized and navigable.

4 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description cleanly states what the skill does and when to use it, with a concrete 'Use when' trigger clause and a well-bounded 'Claude Code hooks' niche. The main weakness is that the listed actions (validates, enforces, prevents) are slightly abstract compared to the specific hook-writing tasks the body actually covers.

DimensionReasoningScore

Specificity

Quotes 'validates design decisions, enforces best practices, and prevents common pitfalls' alongside the 'writing secure, reliable, and performant Claude Code hooks' domain — several concrete actions, but they are somewhat abstract verbs rather than the most granular capabilities (no mention of input validation, exit codes, matchers). Not a 5 because coverage of specific hook-writing actions is implied rather than enumerated; not a 3 because it does list multiple distinct actions beyond a single one.

4 / 5

Completeness

Quote explicitly answers 'what' ('Expert guidance for writing secure, reliable, and performant Claude Code hooks - validates design decisions, enforces best practices, and prevents common pitfalls') and 'when' ('Use when creating, reviewing, or debugging Claude Code hooks') with concrete trigger phrases. Matches the anchor 5 example structure of clear what + explicit 'Use when' clause; not below 5 since both halves are present and concrete.

5 / 5

Trigger Term Quality

Quote: 'Use when creating, reviewing, or debugging Claude Code hooks' provides natural terms a user would say, but misses common synonyms/variations (e.g., 'optimizing hooks', 'securing hooks', 'publishing hooks' that the body covers) and any artifact-style phrasing. Good coverage with a few natural terms missing, so not a 5; clearly more than 'some relevant keywords', so not a 3.

4 / 5

Distinctiveness Conflict Risk

Quote: 'Claude Code hooks' is a clear niche with distinct triggers ('creating, reviewing, or debugging Claude Code hooks') and minimal conflict risk with other skills. It targets a specific artifact type, matching the anchor 5 'clear niche with distinct triggers'; not a 4 because the niche is well-bounded rather than having minor overlap.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
secondsky/claude-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.