CtrlK
BlogDocsLog inGet started
Tessl Logo

setup-matt-pocock-skills

Configure this repo for the engineering skills - set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

67

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable setup skill with a clear sequenced workflow and concrete commands. Its weaknesses are mild verbosity in the explainer blocks and - more importantly - five referenced seed-template files that are not actually bundled, which breaks progressive-disclosure navigation.

Suggestions

Bundle the five referenced seed templates (`issue-tracker-github.md`, `issue-tracker-gitlab.md`, `issue-tracker-local.md`, `triage-labels.md`, `domain.md`) or remove the file references so links resolve.

Tighten the "> Explainer:" blocks to one or two lines each to reduce token overhead while keeping the user-facing guidance.

Consider moving the long `## Agent skills` template block and the per-tracker decision detail into the referenced template files to keep SKILL.md a leaner overview.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete commands and a clear 5-step structure, but the multi-line "> Explainer:" blocks and repeated framing add length that could be trimmed; it is not level 1 because it avoids explaining concepts Claude already knows, and not level 3 because several passages could be tightened.

2 / 3

Actionability

Provides highly concrete, executable guidance - specific commands (`git remote -v`), exact file paths to inspect, explicit decision trees, file-selection rules, and a copy-paste markdown block - which for an instruction-only skill meets the fully-actionable anchor.

3 / 3

Workflow Clarity

The five steps (Explore, Present, Confirm, Write, Done) are clearly sequenced with explicit human-in-the-loop checkpoints ("present a section, get the user's answer, then move to the next", "Let them edit before writing"); it is not level 2 because checkpoints are explicit rather than implicit, and the missing validate-fix-retry loop is not required since this is not a destructive or batch operation.

3 / 3

Progressive Disclosure

The body is a well-organized overview that signals one-level-deep references to seed templates, but the five referenced files (`issue-tracker-github.md`, `issue-tracker-gitlab.md`, `issue-tracker-local.md`, `triage-labels.md`, `domain.md`) do not exist in the skill folder, so navigation is broken; it is not level 3 because following the references leads nowhere, and not level 1 because the structure and signaling are otherwise clean.

2 / 3

Total

10

/

12

Passed

Description

85%

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, third-person description that states concrete actions and an explicit sequencing trigger, with a clear niche unlikely to conflict. Its main weakness is the absence of a natural user-facing trigger phrase, which leaves trigger-term coverage partial.

Suggestions

Add an explicit "Use when..." clause naming how a user would naturally request this (e.g. "Use when setting up Matt Pocock's engineering skills in a repo for the first time") to lift trigger-term coverage.

Surface a couple of common trigger variations ("set up the skills", "initialize skill config") so the description matches what users actually say.

DimensionReasoningScore

Specificity

Names multiple concrete actions - "set up its issue tracker, triage label vocabulary, and domain doc layout" - rather than vague abstractions, matching the multi-action anchor.

3 / 3

Completeness

Explicitly answers both what ("Configure this repo for the engineering skills - set up its issue tracker, triage label vocabulary, and domain doc layout") and when ("Run once before first use of the other engineering skills"), satisfying the both-what-and-when anchor; it is not level 2 because the when clause is explicit, not merely implied.

3 / 3

Trigger Term Quality

Contains relevant domain keywords ("issue tracker", "triage label", "domain doc") a user might say, but lacks a natural "Use when..." trigger phrase and misses common variations, so it sits at the partial-coverage anchor rather than full coverage.

2 / 3

Distinctiveness Conflict Risk

Occupies a clear one-time-setup niche tied to "the engineering skills" with distinct triggers, making it unlikely to fire for the wrong skill; it is not level 2 because the scope is narrowly bounded to repo configuration rather than overlapping generic skills.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing

Warning

Total

15

/

16

Passed

Repository
novuhq/novu
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.