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

74%

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 ./skills/ac-hooks-manager/SKILL.md
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.

The body is well-structured and genuinely actionable — the API examples match the shipped hooks_manager.py and the stop-hook mechanics are documented with concrete JSON and exit codes. Its weaknesses are redundancy (repeated install examples and safety checks), an inlined 50-line script that belongs in the bundle, and a References/Scripts section that mostly points at files that do not exist in the bundle.

Suggestions

Ship the referenced files or fix the lists: either add references/HOOK-MECHANICS.md, STOP-HOOK.md, SAFETY.md and scripts/autonomous-loop.sh, analyze.py, hook_installer.py to the bundle, or trim the References/Scripts sections to what actually exists.

Deduplicate: drop the "Safety Mechanisms" section (it re-pastes checks already visible in the loop script) and merge "Hook Types" install examples into "Operations", replacing repeated code with one-line signatures.

Move the full autonomous-loop.sh out of SKILL.md into the scripts file and keep only the decision logic (stop_hook_active check, limits, exit codes) inline; also replace "$FILE" in the PostToolUse example with the actual stdin JSON extraction.

DimensionReasoningScore

Conciseness

The body is mostly dense code and config, which is good, but there is real duplication: the "Safety Mechanisms" section re-pastes the doom-loop, iteration, and cost checks already shown in full inside the inlined autonomous-loop.sh; "Hook Types" repeats the install calls from Quick Start and "Operations" repeats them again. The complete ~50-line bash script inlined in SKILL.md ("## Autonomous Loop Script") is content that belongs in the scripts/ file, matching the 3 anchor ("could be tightened") rather than the trimmed 4.

3 / 5

Actionability

The Python examples (install_autonomous_hooks, get_status, remove_hook, validate) match the shipped scripts/hooks_manager.py API, the settings.json blocks are concrete, and the stop-hook input/output JSON with exit codes is executable guidance. Minor gaps hold it below 5: the PostToolUse example uses `npx prettier --write "$FILE"` where $FILE is not a documented hook variable, the Quick Start omits `await hooks.initialize()`, and the inlined loop script references a `scripts/analyze.py` that is not in the bundle.

4 / 5

Workflow Clarity

The stop-hook flow is clearly sequenced ("How It Works" steps 1-4 with explicit CONTINUE/COMPLETE decisions), and installation has a validate/status checkpoint (`errors = await hooks.validate()`). It falls short of anchor 5 because there is no feedback loop telling Claude what to do when validation reports errors or how to recover a clobbered settings.json, and the documented loop script diverges from the one actually shipped in hooks_manager.py (state file vs. config file, missing analyzer).

4 / 5

Progressive Disclosure

Section structure is clear and the References/Scripts lists are well-labeled, but scored against the actual bundle they are largely dead: the references/ directory does not exist (HOOK-MECHANICS.md, STOP-HOOK.md, SAFETY.md are all missing) and 3 of the 4 listed scripts are absent — only scripts/hooks_manager.py ships. Combined with the full bash script inlined rather than referenced, this fits anchor 3 ("references present but" effectively unusable, "content that should be separate is inline") rather than the well-placed anchor 4.

3 / 5

Total

14

/

20

Passed

Description

75%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: third-person, concise, with an explicit "Use when" clause covering the domain's main scenarios. It scores uniformly at 4 because every dimension is well-handled but stops short of comprehensive — the capability list and trigger vocabulary could be broadened to match what the body actually offers.

Suggestions

Enumerate the remaining concrete operations in the description (validate hook configuration, remove hooks, check hook status) instead of the generic "installation and management".

Broaden trigger vocabulary with natural synonyms users would say, e.g. "hook configuration", "hook not firing", or "remove/disable hooks".

DimensionReasoningScore

Specificity

"Hook installation and management for autonomous coding" names the domain, and the trigger clause enumerates concrete actions: "setting up Stop hooks, managing pre/post tool hooks, or configuring autonomous continuation". It stops short of a 5 because "installation and management" is generic and it omits operations the body actually supports (validate, remove, status).

4 / 5

Completeness

Both "what" ("Hook installation and management for autonomous coding") and "when" ("Use when setting up Stop hooks, managing pre/post tool hooks, or configuring autonomous continuation") are explicit. The "when" clause is concrete, but the "what" half stays high-level rather than enumerating the specific operations, so it fits anchor 4 rather than the fully concrete anchor 5.

4 / 5

Trigger Term Quality

Natural phrases a user would say are present: "setting up Stop hooks", "managing... hooks", "configuring". It misses common variations and symptom phrasings (e.g. "hook configuration", "hooks not firing", "remove hooks"), which keeps it below the 5 anchor's synonym-level coverage; it is well above the 3 anchor's bare keyword list.

4 / 5

Distinctiveness Conflict Risk

Hook lifecycle management for autonomous continuation is a clear niche with distinct triggers ("Stop hooks", "autonomous continuation") unlikely to fire for the wrong skill. Minor overlap risk remains with closely related config/settings skills, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

16

/

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

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.