CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ac-hooks-manager

Hook installation and management for autonomous coding. Use when setting up Stop hooks, managing pre/post tool hooks, or configuring autonomous continuation.

Quality

72%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/ac-hooks-manager/SKILL.md

The canonical home for this skill is ac-hooks-manager in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

A well-structured, largely actionable skill document whose Python API examples match the actual bundled hooks_manager.py. Its main flaws are redundancy (safety snippets and install examples repeated across sections) and a broken bundle contract: every listed reference file and most listed scripts do not exist, while their supposed content is inlined in SKILL.md.

Suggestions

Delete the duplicated code snippets in 'Safety Mechanisms' (doom-loop, iteration, cost checks already appear in full inside the autonomous-loop.sh listing) and replace them with one-line summaries.

Either create the referenced files (references/STOP-HOOK.md, references/SAFETY.md, references/HOOK-MECHANICS.md) and move the inlined stop-hook I/O specs and safety content into them, or remove the References section — currently all three paths are dangling. Do the same for the three missing scripts listed under 'Scripts'.

Merge 'Hook Configuration', 'Hook Types', and 'Operations' into a single section — they demonstrate the same installs three ways — and drop the repeated install_autonomous_hooks() example already shown in Quick Start.

Add an explicit validation feedback loop: after hooks.validate() reports errors, show how to fix and re-validate before proceeding (hook installation mutates .claude/settings.json).

DimensionReasoningScore

Conciseness

The content is concrete rather than fluffy — no paragraphs explaining concepts Claude already knows — but there is substantial duplication: the 'Safety Mechanisms' section re-pastes three code snippets already shown in full in the autonomous-loop.sh listing, and 'Operations' repeats the Quick Start's install_autonomous_hooks() call. Hook Configuration, Hook Types, and Operations also demonstrate the same installs three different ways. This is 'mostly efficient but could be tightened' (anchor 3) rather than anchor 2, since the padding is duplication of useful content rather than unnecessary explanation.

3 / 5

Actionability

Mostly executable guidance: the full bash stop-hook script, the settings.json config, and Python calls that match the real scripts/hooks_manager.py API (verified: install_stop_hook, install_pre_tool_hook, install_post_tool_hook, install_session_hooks, remove_hook, get_status, validate all exist). Minor gaps keep it from anchor 5: 'project_dir' is undefined in the Quick Start snippet, and three of the four listed scripts (autonomous-loop.sh, analyze.py, hook_installer.py) do not exist in the bundle.

4 / 5

Workflow Clarity

The core Stop-hook flow is clearly sequenced (numbered steps 1-4 with explicit CONTINUE/COMPLETE decision branches and the critical stop_hook_active check), and the hook lifecycle is enumerated with a validate() operation. It falls short of anchor 5 because there is no error-recovery feedback loop after validation ('if errors: fix and re-run') — validate() only prints errors — which matters since installing hooks mutates .claude/settings.json.

4 / 5

Progressive Disclosure

There is real structure — dedicated References and Scripts sections with one-line descriptions, clearly signaled — but all three listed reference files (references/HOOK-MECHANICS.md, references/STOP-HOOK.md, references/SAFETY.md) are missing from the bundle, as are 3 of the 4 listed scripts. Meanwhile deep-dive content (stop-hook I/O specs, the full bash script, safety mechanisms) that those references should hold is inlined in SKILL.md. This lands at anchor 3 ('content that should be separate is inline') and is held below 4 by the dangling reference and script paths.

3 / 5

Total

14

/

20

Passed

Description

70%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.

A solid description with an explicit and well-phrased 'Use when...' clause covering the key hook types. Its main weakness is a generic 'what' — 'installation and management' — which undersells the concrete operations (install, remove, validate, status) the skill actually provides.

Suggestions

Replace the generic 'management' with the concrete operations, e.g., 'Install, remove, validate, and check status of Claude Code hooks (Stop, PreToolUse, PostToolUse, SessionStart/End) for autonomous operation.'

Add common user phrasings to the trigger clause, such as 'install hooks' or 'hook status', which currently appear only in the frontmatter triggers list.

DimensionReasoningScore

Specificity

The description names the domain ('Hook installation and management for autonomous coding') with two concrete actions — installation and management — but 'management' is generic and it does not enumerate the specific operations the skill actually performs (install, remove, validate, check status). This matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive'); score 4 would require several specific actions listed.

3 / 5

Completeness

It has an explicit 'Use when...' clause with concrete trigger phrases, and a 'what' ('Hook installation and management for autonomous coding'). However, the 'what' is thinner than anchor 5's example (which enumerates multiple concrete capabilities); 'installation and management' is high-level. This sits at anchor 4 — both present, with the 'what' lacking the specificity of a 5.

4 / 5

Trigger Term Quality

Phrases like 'setting up Stop hooks', 'managing pre/post tool hooks', and 'configuring autonomous continuation' are natural things a user managing Claude Code hooks would say. A few common variations are missing (e.g., 'install hooks', 'hook status', 'remove hooks' — which appear only in the frontmatter triggers, not the description), so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — Claude Code hooks for autonomous operation, with distinct triggers like 'Stop hooks' and 'autonomous continuation' — so it is mostly distinct with only minor overlap risk against a generic Claude Code settings/configuration skill. It lacks the fully distinctive trigger set of anchor 5.

4 / 5

Total

15

/

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/ac-hooks-manager/SKILL.md

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.