CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

70

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.

A dense, highly actionable reference: complete rule templates, enumerated fields/operators per event, concrete pitfall examples, and a runnable test command. The only real costs are a short regex-primer section Claude does not need and the lack of an explicitly sequenced write→test→enable workflow, plus everything living inline in one file.

Suggestions

Trim or remove the 'Regex Basics' section — Claude already knows \s, +, *, and |; keep only the hookify-specific pitfalls (too broad/too specific patterns, YAML escaping).

Add a brief ordered checklist for authoring a rule (write the file → test the pattern with the given python3 one-liner → confirm naming/location → optionally toggle with /hookify-configure) to make the implicit workflow explicit.

Consider moving the Event Type Guide examples into a small references file to keep SKILL.md as a tighter overview, which would also improve progressive disclosure.

DimensionReasoningScore

Conciseness

The body is lean — tables, terse bullets, and complete rule templates with no padding — but the 'Regex Basics' section ('\s whitespace, \d digit', '+ one or more, * zero or more') explains regex fundamentals Claude already knows. That trimmable block keeps it at the 4 anchor (efficient, minor over-explanation) rather than 5; it is far from the 3 anchor's 'some unnecessary explanation' since it is only a few lines.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste-ready basic rule template, a complete advanced conditions example with real fields, per-event condition field lists, an operator enumeration, a runnable regex test command ('python3 -c "import re; print(re.search(...))"'), exact file naming ('.claude/hookify.{descriptive-name}.local.md'), and a minimum viable rule. Coverage matches the common cases.

5 / 5

Workflow Clarity

The skill is essentially a single task (author a rule) and the body provides an unambiguous format plus a validation checkpoint (the regex testing command) and pitfalls guidance. It sits at the 4 anchor rather than 5 because there is no explicit end-to-end sequence (write rule → test pattern → enable/verify) — the pieces exist but must be assembled, and rule creation is not destructive/batch so no 3-cap applies.

4 / 5

Progressive Disclosure

No bundle files exist, and the document is well-organized with clear sections (Rule File Format, Event Type Guide, Pattern Writing Tips, File Organization, Commands, Quick Reference) and easy navigation. It stays at 4 rather than the simple-skill 5 exception because at ~123 lines the Event Type Guide and regex material are all inlined in one file where a split could apply, though the structure itself is solid.

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.

A strong description that pairs a specific, concrete 'what' (create/configure markdown+YAML rules matching events via regex/conditions with warn/block messages) with an explicit, well-phrased 'Use when' clause containing natural trigger terms. Minor headroom only in breadth of action verbs and synonym coverage.

DimensionReasoningScore

Specificity

Names several concrete actions — 'Create and configure hookify rules', 'match bash, file, prompt, or stop events by regex or conditions and show warn/block messages' — with concrete artifact detail (markdown files with YAML frontmatter). It falls just short of the 5 anchor because the action list (create, configure) is narrower than the multi-action exemplars, though richer than anchor 3's 1-2 actions.

4 / 5

Completeness

Explicitly answers both: what ('Create and configure hookify rules — markdown files with YAML frontmatter that match ... events by regex or conditions and show warn/block messages') and when ('Use when creating a hookify rule, writing hook rule syntax, configuring hookify, or adding pattern guardrails such as...'). This matches the 5 anchor with concrete trigger phrases; voice is third-person/declarative with no person-penalty.

5 / 5

Trigger Term Quality

The 'Use when' clause covers natural phrases users would say: 'creating a hookify rule', 'writing hook rule syntax', 'configuring hookify', 'blocking dangerous commands', '.env edits', or 'debug code', including a file-specific term (.env). Not quite the 5 anchor's comprehensive synonym coverage — a few natural variations (e.g., 'adding hooks', 'safety checks', 'guard rules') are absent.

4 / 5

Distinctiveness Conflict Risk

The 'hookify' niche is clearly staked with distinctive triggers (hookify rules, hook rule syntax, pattern guardrails) and no overlap with generic file/code skills. Only negligible risk of confusion with adjacent hook-related skills, which is below the 4 anchor's 'minor overlap' threshold.

5 / 5

Total

18

/

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