CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

implement

Create an implementation based on a plan.

Quality

52%

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 ./.claude/skills/implement/SKILL.md

The canonical home for this skill is implement in pymc-labs/pymc-marketing

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is commendably brief but provides almost no actionable guidance: instructions are vague, contain a grammatical error, and lack any test-run/fix feedback loop for what is an iterate-until-green workflow. It reads as a stub rather than an operational skill.

Suggestions

Replace vague directives with concrete steps and commands, e.g., '1. Read the plan; consult research/ notes only when a section is ambiguous. 2. Implement each section. 3. Write pytest tests per section. 4. Run `pytest` and fix failures until green.'

Fix the garbled bullet ('You must add follow the plan') and remove the redundant intro line that repeats the heading.

Add an explicit validation/feedback loop — write tests, run `pytest`, iterate on failures — since the workflow currently says to create tests but never to run them.

DimensionReasoningScore

Conciseness

The body is very lean (~4 lines) and explains nothing Claude already knows, matching 'efficient; assumes competence'. It falls short of 5 because the opening line "Based on a plan make an implementation:" is redundant with the heading and description, and "You must add follow the plan" is garbled and could be trimmed to a clean directive.

4 / 5

Actionability

Guidance is high-level only: "follow the plan, and read research if you have questions" and "Make a test for every section... using pytest" give no commands, code, examples, or specifics (e.g., how to run pytest, what a test per section looks like). This matches 'minimal concrete guidance; high-level hints but missing the specific steps'; it is above 1 only because pytest and the per-section test rule are semi-concrete.

2 / 5

Workflow Clarity

The two bullets give only a rough sequence with large gaps: no ordering of implement -> test -> run -> fix, and no validation checkpoint (tests are to be written but nothing says to run them and iterate on failures). This matches 'rough sequence present but many gaps; validation absent'; not 3 because even the step list itself is incomplete and incoherent ('You must add follow the plan').

2 / 5

Progressive Disclosure

As a sub-50-line simple skill with no bundle files (no references/, scripts/, or assets/ exist), well-organized short content can score highly, and nothing here needs splitting out. It is not 5 because the instruction to "read research if you have questions" points at a resource that is neither part of the skill nor clearly signaled, leaving minor navigation/organization gaps.

4 / 5

Total

12

/

20

Passed

Description

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

The description is grammatically clean and third-person, but it is a single generic sentence: one vague action, no trigger guidance, and high overlap risk with general coding skills. It resembles the 'bad overall examples' tier more than the good tier.

Suggestions

Add a 'Use when...' clause stating concrete invocation triggers, e.g., 'Use when the user asks to implement, code, or build an approved plan or specification.'

List the concrete actions the skill performs (e.g., 'Translate a plan section into code, write pytest tests per section, and iterate until tests pass') to raise specificity and distinctiveness.

Include natural user phrasings and synonyms ("implement the plan", "build from the spec", "write the code") to improve trigger term coverage.

DimensionReasoningScore

Specificity

"Create an implementation based on a plan" names a domain (implementation from a plan) with one minimal, generic action verb; there is no listing of what the implementation involves. It sits between the vague anchor 1 and the '1-2 concrete actions' anchor 3, and below it because 'create an implementation' is not a concrete, specific action.

2 / 5

Completeness

There is a clear 'what' ("Create an implementation based on a plan") but no 'when' / 'Use when...' clause at all, which per the guidelines caps completeness at 3. It is not a 4 because nothing implies or states when the skill should be invoked.

3 / 5

Trigger Term Quality

The only candidate keywords are "implementation" and "plan" — one or two generic terms with no natural phrases or variations a user would say (e.g., "implement the plan", "write the code from the plan", "build from spec"). This matches anchor 2; it is above anchor 1 only because the terms are at least domain-relevant rather than jargon.

2 / 5

Distinctiveness Conflict Risk

"Create an implementation based on a plan" is very broad and would overlap with virtually any coding or implementation skill; nothing distinguishes it. It is above anchor 1 only because it is scoped to plan-following rather than being doubly generic.

2 / 5

Total

9

/

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

pymc-labs/pymc-marketing

Path

.claude/skills/implement/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.