CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

setup-matt-pocock-skills

Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.

72

Quality

91%

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 setup-matt-pocock-skills in mattpocock/skills

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.

A well-crafted prompt-driven skill body: concrete commands, a fully sequenced workflow with user-confirmation checkpoints, and clearly signaled one-level-deep references to seed templates. The only deductions are minor restatement in the file-selection rules and the fact that the five referenced template files could not be found in the reviewed bundle to verify.

DimensionReasoningScore

Conciseness

The body is efficient and instruction-dense — the inline explainers are content the skill tells Claude to show the user, not concepts Claude is being taught, so they earn their place. Minor trimming is possible: the AGENTS.md/CLAUDE.md selection rules in step 4 are stated twice ("If neither exists, ask the user which one to create" followed by "Never create AGENTS.md when CLAUDE.md already exists (or vice versa) — always edit the one that's already there"), which is a small amount of restatement.

4 / 5

Actionability

Fully concrete, executable guidance throughout: exact exploration commands ("`git remote -v` and `.git/config`"), exact paths to check, an enumerated decision menu with defaults for each section, precise file-selection rules, and a copy-paste-ready markdown block template. As an instruction-only skill its guidance is directly actionable with no pseudocode.

5 / 5

Workflow Clarity

A clearly sequenced five-step process (Explore → Present findings one at a time → Confirm and edit → Write → Done) with explicit checkpoints: findings must be presented and approved per section, the user edits drafts before anything is written, and the write step guards against the risky cases (update the existing `## Agent skills` block in place, never create a duplicate file, never overwrite surrounding user edits). These confirmation and idempotency rules serve as the validation appropriate for config-file mutation.

5 / 5

Progressive Disclosure

The body is well structured with a clear overview and well-signaled one-level-deep references to five seed templates, each listed with its purpose ("[issue-tracker-github.md](./issue-tracker-github.md) — GitHub issue tracker", etc.). However, none of the referenced template files were present in the reviewed skill folder, so the referenced bundle could not be verified — a minor organization/verification gap rather than a structural one.

4 / 5

Total

18

/

20

Passed

Description

92%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: concrete, third-person, and comprehensive about what it does, with an explicit run-before trigger clause tied to the dependent skills. The only gap is a handful of missing natural synonyms (e.g., "configure", "initialize") that would broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names exact artifacts ("Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/`") and comprehensively enumerates the three configuration areas ("issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout"), matching the comprehensive-coverage anchor. It is written in third person ("Sets up"), consistent with the guidelines.

5 / 5

Completeness

It explicitly answers both questions: the "what" ("Sets up an `## Agent skills` block ... so the engineering skills know this repo's issue tracker, triage label vocabulary, and domain doc layout") and the "when" ("Run before first use of ... or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs"), with concrete trigger conditions.

5 / 5

Trigger Term Quality

Good keyword coverage including natural terms users would say — "set up", "issue tracker", "GitHub", "local markdown", "triage", "domain docs" — plus the named dependent skills ("to-issues", "to-prd", "triage", "diagnose", "tdd", "improve-codebase-architecture", "zoom-out"). A few natural synonyms such as "configure" or "initialize" are missing, so it sits between the good (4) and comprehensive (5) anchors.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — per-repo configuration scaffolding for a specific named set of engineering skills and specific files (AGENTS.md/CLAUDE.md, docs/agents/) — with explicit trigger conditions tied to those skills, so conflict risk with other skills is minimal.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 5 missing

Warning

Total

15

/

16

Passed

Repository

SnowingFox/ai-skills

Path

.cursor/skills/setup-matt-pocock-skills/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.