CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

click-path-audit

Trace every user-facing button/touchpoint through its full state change sequence to find bugs where functions individually work but cancel each other out, produce wrong final state, or leave the UI in an inconsistent state. Use when: systematic debugging found no bugs but users report broken buttons, or after any major refactor touching shared state stores.

Quality

81%

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

The canonical home for this skill is click-path-audit in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

67%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 highly actionable, well-sequenced audit procedure whose main weaknesses are redundancy and token weight: the flagship bug example is repeated three times, some patterns re-teach known React concepts, and no findings-verification step exists before reporting. Structure is solid, but the body would benefit from splitting reference material out of SKILL.md.

Suggestions

Tell the "New Email" bug once: cut the closing "Example: The Bug That Inspired This Skill" section (or fold it into "The Problem This Solves") — the store definition and trace currently appear in both places, saving ~40 lines (conciseness).

Move the six-pattern catalog and the full store-definition walkthrough to a references/ file (e.g., references/patterns.md) linked one level deep, keeping SKILL.md as the procedure overview (conciseness, progressive_disclosure).

Add a verification checkpoint before reporting — e.g., confirm each suspected conflict by reading the actual store action and checking other callers, and define what separates CRITICAL/HIGH/MEDIUM/LOW severities (workflow_clarity, actionability).

DimensionReasoningScore

Conciseness

The core workflow (store mapping, touchpoint audit templates, report format, scope control) is lean and every line instructs, but the motivating "New Email" bug is told three times — in "The Problem This Solves", in Step 1's store map, and again in a ~35-line closing example that repeats the full store definition — and Pattern 3 (Stale Closure) and Pattern 2 (Async Race) re-explain React concepts Claude already knows. It is not anchor 2 because the majority of the body is tight, actionable material rather than padding, and not anchor 4 because the redundancy (roughly a quarter of the body, plus the app-specific page inventory in the agent split) is more than minor trimming.

3 / 5

Actionability

The skill supplies copy-paste-ready output templates for store maps ("actionName → {sets: [...], resets: [...]}"), per-touchpoint audits, and bug reports, plus six named patterns with code sketches and a structured report format — highly executable for an instruction-only skill. It falls short of anchor 5 on minor gaps: no method is given for enumerating "EVERY interactive touchpoint" (e.g., grepping for onClick/onSubmit), and the CRITICAL/HIGH/MEDIUM/LOW severity levels are used without definitions, leaving severity assignment to guesswork.

4 / 5

Workflow Clarity

The three-step sequence (map stores → audit touchpoints → report) is clearly ordered with an explicit cross-agent dependency ("Agent 1 MUST complete first. Its output is input for all other agents.") and a six-point CHECK list that functions as a per-touchpoint checkpoint. It misses anchor 5 because there is no verification feedback loop on findings — nothing instructs confirming a suspected reset by reading the store definition or checking other callers before reporting, so false positives can flow straight into the report; it is well above anchor 3, whose sequence lacks checkpoints entirely.

4 / 5

Progressive Disclosure

This is a single-file skill (no references/, scripts/, or assets/ directories exist in the bundle) with clear, well-signaled section headers and a logical overview-to-detail flow. Structure is good, but the ~245-line body inlines content that would fit a one-level-deep reference — the six-pattern catalog and the closing walkthrough — which keeps it below the ideal split of anchor 5 while remaining clearly better organized than the inline-bloat of anchor 3.

4 / 5

Total

15

/

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: it names a concrete, distinctive capability, gives concrete failure modes, and provides an explicit two-condition "Use when" trigger that also distinguishes it from general debugging. The only improvement space is adding a few more natural trigger synonyms ("button does nothing", "click").

DimensionReasoningScore

Specificity

The description states a concrete action ("Trace every user-facing button/touchpoint through its full state change sequence") and enumerates concrete bug classes ("functions individually work but cancel each other out, produce wrong final state, or leave the UI in an inconsistent state"). It centers on a single core action rather than the multiple distinct actions of anchor 5, but its failure modes are far more concrete than the 1-2 generic actions of anchor 3, placing it noticeably above the midpoint.

4 / 5

Completeness

Both halves are explicit: the "what" is tracing touchpoints through their state-change sequences to find state-interaction bugs, and the "when" is a dedicated "Use when: systematic debugging found no bugs but users report broken buttons, or after any major refactor touching shared state stores" clause with concrete trigger conditions. This directly matches the anchor-5 example structure of clear what plus explicit when with concrete triggers; anchor 4's "when could be more explicit" does not apply.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "users report broken buttons", "after any major refactor", "shared state stores" — with relevant technical terms like Zustand-style state implied via "state change sequence". A few common variations are missing ("click", "button does nothing", "nothing happens", "UI"), so it does not reach the comprehensive synonym coverage of anchor 5, but it clearly exceeds the partial coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — auditing UI handler state interactions (sequential undo, async races, inconsistent final state) — and the trigger clause explicitly differentiates it from generic debugging ("systematic debugging found no bugs but users report broken buttons"), which minimizes the chance of firing for ordinary bug-hunting or API/styling skills. Anchor 4's "minor overlap risk with closely related skills" is not present because the boundary against the nearest neighbor (systematic debugging) is stated in the trigger itself.

5 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/click-path-audit/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.