CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

74%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/setup-matt-pocock-skills/SKILL.md

The canonical home for this skill is setup-matt-pocock-skills in mattpocock/skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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-sequenced, token-efficient interactive setup workflow with concrete defaults, decision rules, and user confirmation before writing. Its main defect is that Step 4 relies on five seed-template bundle files that do not exist in the skill folder, which breaks both executability and the reference layer.

Suggestions

Ship the five referenced seed templates (`issue-tracker-github.md`, `issue-tracker-gitlab.md`, `issue-tracker-local.md`, `triage-labels.md`, `domain.md`) alongside SKILL.md, or inline minimal template content so the docs files can actually be produced without them.

Add a brief post-write verification step in Section 4 (e.g., re-read the edited CLAUDE.md/AGENTS.md block and confirm the `## Agent skills` section is well-formed and no user content was disturbed) to close the workflow_clarity validation gap.

Trim the duplicated CLAUDE.md/AGENTS.md selection rule and shorten the Section A 'Explainer', which restates what an issue tracker is, to tighten conciseness.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence (e.g., a bulleted exploration checklist rather than tutorial prose), with only minor over-explanation — the Section A "Explainer" restates what an issue tracker is, and the CLAUDE.md/AGENTS.md selection rule is stated twice ("Never create AGENTS.md when CLAUDE.md already exists (or vice versa); always edit the one that's already there"). Fits anchor 4, not 5.

4 / 5

Actionability

Concrete commands and paths are given (`git remote -v`, `pnpm-workspace.yaml`, the five default label strings, the full `## Agent skills` block template), but Step 4 depends on "the seed templates in this skill folder" — links to `./issue-tracker-github.md`, `./issue-tracker-gitlab.md`, `./issue-tracker-local.md`, `./triage-labels.md`, and `./domain.md` — and none of these files exist in the bundle. The content of three of the four output files is unreachable, which is a missing key detail (anchor 3), more than a minor gap.

3 / 5

Workflow Clarity

A clear five-step sequence (Explore → Present findings → Confirm and edit → Write → Done) with explicit conditional skips ("Skip this section entirely if the `triage` skill isn't installed") and a user confirm-and-edit checkpoint before any file is written. Post-write verification is absent (no check that the `## Agent skills` block landed correctly), so it sits at anchor 4 rather than 5.

4 / 5

Progressive Disclosure

References are one level deep and each is labeled with its purpose, which would rate highly — but all five referenced bundle files are absent from the skill folder, so the promised detail layer is non-functional and navigation dead-ends. Structure is good yet the reference layer is broken (anchor 3).

3 / 5

Total

14

/

20

Passed

Description

75%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 solid, third-person description that names three concrete setup deliverables and gives an explicit run-timing clause. It scores uniformly at 4: specific and distinct but not exhaustive, with a when-clause that states sequencing rather than a natural user-trigger phrase.

DimensionReasoningScore

Specificity

Names the domain (per-repo setup for the engineering skills) and three concrete deliverables — "set up its issue tracker, triage label vocabulary, and domain doc layout" — but each is a category rather than a fully enumerated action list, leaving minor gaps in coverage (anchor 4, not 5).

4 / 5

Completeness

Both parts are present: a clear what ("set up its issue tracker, triage label vocabulary, and domain doc layout") and an explicit when ("Run once before first use of the other engineering skills"). The when-clause expresses lifecycle sequencing rather than a concrete user-request trigger phrase, so it falls just short of anchor 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "set up", "configure this repo", "issue tracker", "triage labels", "domain docs" — but misses common synonyms a user might say such as "initialize", "bootstrap", or "scaffold" (anchor 4, not 5).

4 / 5

Distinctiveness Conflict Risk

Clear niche — one-time repo configuration for a specific skill suite — with distinct triggers, so it is unlikely to fire for the wrong skill; minor overlap remains with generic repo-init or configuration skills, keeping it below anchor 5.

4 / 5

Total

16

/

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

tonykay/transcriber

Path

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