CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-hook

Create Cursor hooks. Use when you want to create a hook, write hooks.json, add hook scripts, or automate behavior around agent events.

Quality

86%

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

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

Highly actionable, well-structured content consisting almost entirely of non-obvious Cursor-specific details, with copy-paste-ready examples and a workflow that includes explicit validation steps and troubleshooting feedback loops. The only improvements are trimming the operational advice repeated across sections and the final checklist's partial duplication of the workflow steps.

DimensionReasoningScore

Conciseness

Nearly all content is Cursor-specific knowledge Claude would not already have (event names, matcher regex syntax, per-event output fields, exit-code semantics) with no padding or explanations of known concepts. Key operational points are repeated across sections — matcher debugging, making scripts executable, and path rules each appear 2-3 times (e.g. in both 'Matchers' and 'Validation and Troubleshooting') — so it is efficient with minor trimming possible rather than score-5 lean.

4 / 5

Actionability

Examples are fully executable and copy-paste ready: a complete hooks.json, a working bash script that reads stdin JSON with jq and returns valid permission JSON, a prompt hook example, plus exact matcher values ('curl|wget|nc ') and per-event output fields. This matches the score-5 anchor ('copy-paste ready code or commands; specific examples cover the common cases'); score 4 would imply gaps in the examples.

5 / 5

Workflow Clarity

The 9-step 'Implementation Workflow' has explicit validation checkpoints ('Trigger the relevant action to test the hook', 'Verify behavior in Cursor's Hooks settings tab or the Hooks output channel'), an error-recovery feedback loop ('remove the matcher and confirm the base hook works before tightening it'), and a final checklist. This clearly matches the score-5 anchor including feedback loops and checklists for complex processes.

5 / 5

Progressive Disclosure

A single well-sectioned SKILL.md with clear headers and no bundle files to reference; the content is cohesive process guidance plus compact lookup tables (the event list and 'Event Output Cheat Sheet') that could arguably move to a reference file. Good structure with minor organization gaps fits score 4 — above score 3's misplaced inline content, but not the score-5 pattern of an overview with well-signaled one-level-deep references.

4 / 5

Total

18

/

20

Passed

Description

78%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 explicitly answers both what it does and when to use it, with concrete trigger phrases and good natural keyword coverage. The main issues are the second-person phrasing in the trigger clause (penalized on specificity per the rubric guidelines) and a generic final capability clause that leaves minor coverage gaps.

Suggestions

Rewrite the trigger clause in third person — e.g. 'Use when the user wants to create a hook, write hooks.json, or add hook scripts' — since 'Use when you want to...' is second person and is penalized by the rubric.

Replace the generic 'automate behavior around agent events' with concrete capabilities such as 'block or approve tool calls, shell commands, and MCP calls, or inject follow-up context after agent events' to close the coverage gap.

Add natural synonyms such as 'event handlers', 'hook configuration', or 'hook triggers' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'create a hook', 'write hooks.json', 'add hook scripts' — though 'automate behavior around agent events' is generic, which alone would fit the score-4 anchor ('several specific actions; minor gaps in coverage'). However, the trigger clause 'Use when you want to create a hook...' is written in second person, and the judging guidelines mandate reducing the specificity score by 1 for second-person voice, bringing it to 3.

3 / 5

Completeness

'Create Cursor hooks' explicitly states the what, and 'Use when you want to create a hook, write hooks.json, add hook scripts, or automate behavior around agent events' is an explicit when clause with multiple concrete trigger phrases. This clearly matches the score-5 anchor; score 4 would require the when to be less explicit or specific.

5 / 5

Trigger Term Quality

Natural terms a user would actually say are present — 'create a hook', 'hooks.json', 'hook scripts', 'agent events' — but common variations such as 'event handler', 'hook configuration', or 'trigger script' are missing. This matches the score-4 anchor ('good keyword coverage; a few natural terms missing') rather than 5's comprehensive synonym and extension coverage.

4 / 5

Distinctiveness Conflict Risk

'Cursor hooks', 'hooks.json', and 'agent events' pin a clear niche, but the bare trigger 'create a hook' could also fire for git-hook or React-hook requests, giving minor overlap risk. This fits the score-4 anchor ('mostly distinct; minor overlap risk with closely related skills') rather than 5's minimal conflict risk.

4 / 5

Total

16

/

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

saski/arnesto

Path

.cursor/skills-cursor/create-hook/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.