CtrlK
BlogDocsLog inGet started
Tessl Logo

make-plan

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

49

Quality

53%

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

Quality

Content

57%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean and organized with a clear verification stance, but it lacks a concrete sequenced workflow and executable specifics, relying on vague placeholders like '(research/command)'. It is a reasonable skeleton that would benefit from sharper actionability.

Suggestions

Convert the 'You must' bullet list into a numbered, ordered workflow so the sequence (research -> ask -> verify -> proceed) is explicit.

Replace the vague '(research/command)' with a concrete example of how to spawn and run a verification task.

Drop the advisory tone-setting sentence and merge the redundant verification bullets to improve token efficiency.

DimensionReasoningScore

Conciseness

The body is short and avoids explaining concepts Claude already knows, but the advisory line ('skeptical, thorough...high-quality technical specifications') is mild padding and the two verification bullets ('Spawn new research tasks to verify' and 'Only proceed once you've verified the facts yourself') overlap and could be tightened.

2 / 3

Actionability

It gives a concrete output path ('.cursor/plans/{plan_name_folder} ... .md') and a verification directive, but '(research/command)' is vague and there are no specific commands or examples, leaving key details incomplete.

2 / 3

Workflow Clarity

There is an explicit verify-before-proceed checkpoint ('Only proceed once you've verified the facts yourself'), but the steps are an unordered obligation list rather than a clearly sequenced workflow, and the checkpoints are otherwise implicit.

2 / 3

Progressive Disclosure

This is a simple skill under 50 lines with no external bundle files; the content is organized into a heading and a bulleted must-do list, which the rubric's simple-skills note permits to score 3.

3 / 3

Total

9

/

12

Passed

Description

50%

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 conveys the skill's purpose at a high level but is missing an explicit usage trigger and only loosely specifies concrete actions. It reads more as a process characterization than a clearly-scoped, distinct capability.

Suggestions

Add an explicit 'Use when...' trigger clause naming natural user phrases (e.g., 'Use when the user asks to plan implementation work from research or discoveries').

List the concrete deliverables/actions (e.g., 'define a to-do list, verify facts via research tasks, write a plan to .cursor/plans/') instead of the abstract 'interactive, iterative process'.

Tighten the niche wording so it is clearly distinct from generic planning or research-assistant skills.

DimensionReasoningScore

Specificity

Names the domain ('document research') and one concrete action ('Create a plan'), but does not list multiple specific actions; 'interactive, iterative process' is abstract rather than a concrete capability.

2 / 3

Completeness

It states what the skill does ('Create a plan based on document research') but never says when Claude should use it; the judging guidelines cap completeness at 2 for a missing 'Use when...' clause.

2 / 3

Trigger Term Quality

Includes some natural terms users might say ('plan', 'research'), but lacks common variations and has no explicit trigger phrasing, so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

The 'document research' framing is somewhat specific, but generic planning language could overlap with other planning or research skills, so conflict risk remains.

2 / 3

Total

8

/

12

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.