CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wf-shape

This skill should only be used when the user uses the word workflow and asks to shape a project from messy inputs into a de-risked, de-scoped shaped packet (brief, breadboard, risks, spikes) ready for wf-plan, with handoff/pickup boundaries to avoid context rot.

69

Quality

87%

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

85%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 lean, well-sequenced process document with mandatory checkpoints, verification, and explicit decision gates — genuinely strong workflow clarity and token efficiency. The notable gap is navigation: the two bundled templates in references/ are orphaned, never linked from the steps that need them, and a few steps defer to external skills without stating their expected outputs.

Suggestions

Link the existing templates from the relevant steps, e.g. step 4 "Write risk-register.md using references/risk-register-template.md" and step 5 "using references/spike-section-template.md", so the bundle files are discoverable and consistently used.

Add explicit recovery guidance for the NO-GO path (e.g. "if NO-GO, return to step 4 to treat unresolved risks before re-running the decision"), since Go/No-Go currently states the conditions but not the follow-up action.

For steps that invoke external skills (breadboarding, oracle), state the expected output shape or link to where it is defined, so the step is executable even if the invoked skill's behavior is unfamiliar.

DimensionReasoningScore

Conciseness

The body is lean throughout: steps are compressed bullet instructions ("Hard requirements: goals + non-goals; in-scope/out-of-scope perimeter; top risks + unknowns") with no explanation of concepts Claude already knows and no padding. Every token earns its place, matching anchor 5; anchor 4 would require instances of over-explanation to trim, and there are essentially none.

5 / 5

Actionability

Concrete, specific guidance throughout: named skill invocations ("Invoke breadboarding skill", "Run create-json-prd skill"), exact paths ("docs/04-projects/<lane>/<id>_<slug>/"), and defined artefacts per step. Not anchor 5: several steps rely on external skills whose inputs/outputs are not specified here, and steps 4-5 ignore the ready-made templates that exist in references/, leaving minor execution gaps.

4 / 5

Workflow Clarity

A 15-step numbered sequence with resume logic (step 0 pickup), mandatory checkpoints (step 6 "Oracle bundle (mandatory)", step 7 "mandatory, before PRD creation"), a review-and-revise feedback loop (steps 8-9 review the oracle pass and update dossier files), a Verification checklist, and explicit GO/NO-GO criteria. Clear sequence with explicit validation and feedback loops matches anchor 5.

5 / 5

Progressive Disclosure

The body itself is well-sectioned (Purpose, Inputs, Outputs, Steps, Verification, Go/No-Go), but the bundle contains references/risk-register-template.md and references/spike-section-template.md that are never referenced anywhere — step 4 says only "Write risk-register.md" and step 5 "Record results in spike-investigation.md" without signaling the templates. This matches anchor 3 ("references present but not clearly signaled"); anchor 4 would require the references to be mostly clearly linked.

3 / 5

Total

17

/

20

Passed

Description

83%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 that explicitly states both what the skill produces (a de-scoped shaped packet with brief, breadboard, risks, and spikes) and when to invoke it. Its main weaknesses are the brittle literal single-word trigger ("the word workflow") and reliance on methodology jargon that may not match how users naturally phrase the need.

Suggestions

Replace the literal single-word gate ("only when the user uses the word workflow") with a broader natural trigger clause, e.g. "Use when the user wants to shape, scope, or de-risk a project or idea before planning it".

Add plain-language synonyms alongside the methodology jargon (e.g. "scope down", "define the perimeter", "triage an idea") so the description triggers on phrasings users actually say.

DimensionReasoningScore

Specificity

The description names the domain and concrete artefacts — "shape a project from messy inputs into a de-risked, de-scoped shaped packet (brief, breadboard, risks, spikes) ready for wf-plan, with handoff/pickup boundaries" — going beyond the 1-2 actions of anchor 3, but it centers on a single shaping action rather than the multiple distinct actions of anchor 5. Voice is neutral third-person, so no voice penalty applies.

4 / 5

Completeness

Both questions are explicitly answered: the what ("shape a project from messy inputs into a de-risked, de-scoped shaped packet (brief, breadboard, risks, spikes) ready for wf-plan") and the when ("should only be used when the user uses the word workflow and asks to shape a project"). The when is explicit and concrete, matching anchor 5 rather than anchor 4 where the when could be more specific.

5 / 5

Trigger Term Quality

Good natural-term coverage ("workflow", "shape a project", "messy inputs", "de-risked", "de-scoped", "risks, spikes", "handoff/pickup"), sitting noticeably above anchor 3. Not anchor 5: the gate "should only be used when the user uses the word workflow" is a single literal keyword and misses common variations a user would naturally say ("scope this down", "define the perimeter", "triage this idea").

4 / 5

Distinctiveness Conflict Risk

Clear niche within its skill family, ending "ready for wf-plan, with handoff/pickup boundaries to avoid context rot", but the generic word "workflow" as the trigger gate carries minor overlap risk with unrelated workflow-related skills (CI workflows, workflow tooling). Mostly distinct with minor overlap risk matches anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

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

marchatton/agent-skills

Path

.agents/skills/02-shape/wf-shape/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.