CtrlK
BlogDocsLog inGet started
Tessl Logo

ce-strategy

Create or update STRATEGY.md. Use when starting a product, adding a strategy doc, or changing direction or roadmap.

71

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

92%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-engineered process skill: explicit phase routing, concrete interview mechanics, hard loop bounds, and a clean division of labor with real, clearly-signaled one-level-deep references. The only trim opportunity is the overlap between the Boundaries section and update-run.md's ownership rules.

DimensionReasoningScore

Conciseness

The body is dense, instruction-only prose with zero padding and no explanations of concepts Claude already knows — every line directs behavior. The one trimsite is the 'Meaning is the contract' bullet in Boundaries, which restates the ownership rules that references/update-run.md (itself a required read) defines in full, putting it at 'efficient; minor instances of over-explanation that could be trimmed' rather than the score-5 'every token earns its place'.

4 / 5

Actionability

Guidance is fully concrete and executable for an interview-style skill: exact routing rules ('no file -> Phase 1... file exists -> Phase 2'), the literal announcement lines to use, the ordered nine-section question list, and hard numbers ('three to five lines', 'two-round cap', '3-5 lines' summary). Per the scoring note, absence of code is not penalized in an instruction-only skill when the guidance is actionable, and here it is, down to fallback behavior when the blocking-question tool is missing.

5 / 5

Workflow Clarity

The multi-phase process is clearly sequenced with explicit checkpoints and feedback loops: Phase 0 routes on file state and shows the repo model 'before the first question' with an invitation to correct it; Phase 1 ends by presenting the full draft and offering an edit round; pushback has an explicit loop bound ('a section the user could not sharpen in two rounds is written as given'); and a 'Done:' definition closes the run. Editing a shared doc is protected by ownership rules and never-touch conditions, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The body is an overview plus routing, with all detail correctly pushed to four real, substantive reference files (grounding.md, interview.md, strategy-template.md, update-run.md) verified to exist. Each load is clearly signaled ('non-optional load', 'required read') with exactly when to read it, and cross-references stay one level deep. This matches the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

19

/

20

Passed

Description

82%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 concise, well-structured description with an explicit and specific 'Use when...' clause and a distinct niche. Its only weakness is thin capability coverage — it says create/update but not what the strategy doc contains or how the skill goes about it.

Suggestions

List one or two more concrete capabilities in the 'what' half (e.g. 'captures positioning, users, key metrics, and investment tracks') to move specificity from 1-2 actions toward several specific actions.

Add a natural synonym or two to the trigger clause (e.g. 'product strategy' or 'vision') to broaden the phrases users would actually say.

DimensionReasoningScore

Specificity

The description names the artifact ('STRATEGY.md') and two concrete actions ('Create or update'), matching the anchor 'names domain and 1-2 concrete actions, but not comprehensive'. It does not list several specific actions (e.g. what the doc captures — positioning, metrics, tracks), so it falls below the score-4 anchor.

3 / 5

Completeness

It explicitly answers both: 'what' ('Create or update STRATEGY.md') and 'when' with concrete trigger phrases ('Use when starting a product, adding a strategy doc, or changing direction or roadmap'). This matches the score-5 anchor, which requires explicit what and when with concrete triggers; it is not the score-4 case because the 'when' is already fully explicit and specific.

5 / 5

Trigger Term Quality

'starting a product, adding a strategy doc, or changing direction or roadmap' are natural phrases a user would say, giving good keyword coverage. A few common synonyms are missing ('strategy document', 'product strategy', 'vision'), which keeps it below the comprehensive score-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is clear: a specific repo-root artifact (STRATEGY.md) with distinct triggers (product start, direction/roadmap change). Minimal overlap with related planning skills, matching the score-5 'clear niche with distinct triggers' anchor rather than the score-4 'minor overlap risk' anchor.

5 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
EveryInc/compound-engineering-plugin
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.