CtrlK
BlogDocsLog inGet started
Tessl Logo

make-plan

Create a plan based on document research through an interactive, iterative process.

54

Quality

60%

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 ./.cursor/skills/make-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 a concise, well-structured instruction skill with a clear verify-before-proceed feedback loop. Its main weakness is actionability: directives are concrete in intent but lack specific examples or commands that make execution unambiguous.

Suggestions

Add a brief concrete example of a to-do list entry or a sample plan file path/format to make the 'define a to-do list' step executable.

Specify the order of operations between 'ask the user' and 'spawn research tasks to verify'.

Clarify what a 'research/command' task invocation looks like so Claude knows exactly how to spawn it.

DimensionReasoningScore

Conciseness

The body is short and lean with no padding or explanation of concepts Claude already knows; only the opening framing sentence slightly overlaps the description.

4 / 5

Actionability

It gives concrete directives (define a to-do list, spawn research tasks, read specific files) but steps like "ask the user" stay high-level and there are no concrete examples or commands tying them to execution.

3 / 5

Workflow Clarity

A clear sequence exists with an explicit validation loop ("Spawn new research tasks to verify... Only proceed once you've verified the facts yourself"), with only minor gaps in ordering between asking the user and spawning tasks.

4 / 5

Progressive Disclosure

A single short skill with no bundle files and a well-organized header plus bullet list fits the simple-skill exception that allows a 5 without external references.

5 / 5

Total

16

/

20

Passed

Description

50%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 states a clear purpose but stops at one action and omits any 'when to use' trigger guidance. It is readable and specific enough to be useful, yet generic enough to risk overlap with other planning skills.

Suggestions

Add a 'Use when...' clause naming natural user triggers (e.g. "Use when the user asks for an implementation plan based on research findings").

List 1-2 more concrete actions to broaden coverage (e.g. verifying facts, structuring a to-do list).

Include synonyms/file-type triggers to improve distinctiveness from other planning skills.

DimensionReasoningScore

Specificity

"Create a plan based on document research through an interactive, iterative process" names a concrete action and domain, but lists only one action rather than a comprehensive set.

3 / 5

Completeness

It clearly states the 'what' (create a plan from research) but has no 'Use when...' clause or equivalent 'when' guidance, which caps completeness at 3 per the rubric.

3 / 5

Trigger Term Quality

Relevant keywords ("plan", "document research") appear but common natural trigger phrases and synonyms a user would say (e.g. "implementation plan", "make a plan") are missing.

3 / 5

Distinctiveness Conflict Risk

"Create a plan based on document research" is somewhat specific but the broad concept of planning/research could overlap with other similar skills, and no trigger phrases disambiguate it.

3 / 5

Total

12

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pymc-labs/pymc-marketing
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.