CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hookify-rules

Create and configure hookify rules — markdown files with YAML frontmatter that match bash, file, prompt, or stop events by regex or conditions and show warn/block messages to the agent. Use when creating a hookify rule, writing hook rule syntax, configuring hookify, or adding pattern guardrails such as blocking dangerous commands, .env edits, or debug code.

Quality

90%

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

75%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 strong, actionable reference for the hookify rule format: concrete examples, field tables, and executable testing guidance throughout. The main weaknesses are the padded 'Regex Basics' section teaching concepts Claude already knows, a duplicated minimal example, and the absence of an explicitly ordered creation workflow with a rule-triggers-as-expected verification step.

Suggestions

Delete the 'Regex Basics' subsection — Claude already knows \s, \d, +, *, and | — and keep only the hookify-specific pitfalls (YAML escaping, too-broad/too-specific patterns) as a short 'Pattern tips' list, tightening the conciseness score.

Drop the 'Quick Reference' minimal example (or replace the earlier 'Basic Structure' block with it) to remove duplication and recover token budget.

Add a short ordered workflow — 1) create .claude/hookify.{name}.local.md, 2) test the pattern with the python3 one-liner, 3) verify the rule appears via /hookify-list and triggers on a sample command — to close the validation gap in workflow clarity.

DimensionReasoningScore

Conciseness

The body is mostly efficient (tables, tight examples), but the 'Regex Basics' section ('\s whitespace, \d digit', '+ one or more') explains regex concepts Claude already knows, and the 'Quick Reference' minimal example duplicates the 'Basic Structure' example. This fits 'mostly efficient but includes some unnecessary explanation'; it is not a 4 because a full section of known-concept padding is more than a minor instance, and not a 2 because the bulk is lean and unpadded.

3 / 5

Actionability

The guidance is fully executable: complete copy-paste-ready rule examples (basic and multi-condition), a frontmatter field table, condition fields enumerated per event, an operator list, a concrete naming/location convention, and an executable test command ('python3 -c "import re; print(re.search(...))"'). This matches the copy-paste-ready anchor covering common cases.

5 / 5

Workflow Clarity

The creation workflow (write rule → test pattern → place file → gitignore) is present across sections with a Testing checkpoint and runtime-behavior details, but the steps are never sequenced as an ordered procedure and there is no feedback loop for verifying a rule actually loads and triggers. This fits 'clear sequence with most checkpoints present; minor validation gaps' rather than the 5 anchor's explicit validation steps and error-recovery loops.

4 / 5

Progressive Disclosure

No bundle files exist, and the single SKILL.md is well organized with clear section headers, a quick-reference example, and a pointer to '/hookify-help' for full documentation. The only misplaced content is the generic regex tutorial, which belongs in a reference file (or nowhere) — 'most content is appropriately placed' with minor organization gaps, just short of the well-split, easy-navigation 5 anchor.

4 / 5

Total

16

/

20

Passed

Description

100%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 is exemplary: concrete third-person capability statements, an explicit and specific 'Use when…' clause with natural trigger phrases, and a well-defined niche. It closely mirrors the rubric's good-overall examples with no weaknesses to flag.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Create and configure hookify rules', matching 'bash, file, prompt, or stop events by regex or conditions', and showing 'warn/block messages' — with comprehensive coverage of the skill's capabilities. It matches the anchor for multiple specific concrete actions; no coverage gaps justify a 4.

5 / 5

Completeness

It explicitly answers both what the skill does (create/configure hookify rules that match events by regex or conditions and show warn/block messages) and when to use it via an explicit 'Use when…' clause with concrete trigger phrases. This matches the anchor for clearly and explicitly answering both; the 4 anchor's weaker 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

'Use when creating a hookify rule, writing hook rule syntax, configuring hookify, or adding pattern guardrails such as blocking dangerous commands, .env edits, or debug code' covers the natural phrases a user would say, including concrete example triggers. Nothing common is missing, so it fits the comprehensive-coverage anchor rather than the 4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The description targets a clear niche — hookify rules specifically — with distinct triggers ('hookify rule', 'hook rule syntax', 'pattern guardrails'), so it is unlikely to fire for the wrong skill. It matches the clear-niche/minimal-conflict anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

affaan-m/ECC

Path

skills/hookify-rules/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.