CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

inno-pipeline-planner

Guides the user through an interactive conversation to define their research project, then generates research_brief.json and tasks.json. Use when starting a new project, when no research_brief.json exists, when the user wants to start from a specific pipeline stage, or when the user wants to redefine their research pipeline.

Quality

86%

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

78%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-structured interactive-planning skill: concise, directive, with an excellent progressive-disclosure architecture and a clearly sequenced five-step workflow. The main gaps are the absence of an explicit post-write validation step and slight reliance on referenced files for terms used in the body.

Suggestions

Add a validation step after step 3: re-read the written research_brief.json/tasks.json against references/brief-schema.md and tasks-schema.md and fix any mismatches before summarizing.

Deduplicate the reference listings (top of file and step 3) and drop the authoring note "Keep this file short" from the runtime body.

Inline a minimal example of one task entry (or link directly to the blueprint section of the schema) so 'blueprint' and 'sections.*' are grounded without opening every reference.

DimensionReasoningScore

Conciseness

The body is lean and directive — no explanations of concepts Claude already knows, just project-specific rules, and it explicitly delegates schemas to references ("Keep this file short. Load full schemas and field-level rules from..."). Not 5 because of small redundancies: the reference list appears twice (top of file and again in step 3), and "Keep this file short" is an authoring note rather than runtime instruction.

4 / 5

Actionability

Concrete, executable guidance throughout: exact paths to inspect, a verbatim question to ask ("Do you already have a research idea, experimental results, or are you starting from scratch?"), and an explicit condition→startStage mapping table. Not 5 because key terms like "blueprint" and "sections.*" are only defined in the referenced files, and there are no inline examples of the JSON structures the steps ultimately produce.

4 / 5

Workflow Clarity

Five clearly sequenced steps with decision branches (step 1 branches on existing brief; step 5 gives distinct rules for content vs. structural changes) and a confirmation checkpoint in step 4 ("Summarize and confirm next action"). Not 5 because there is no explicit verification that written JSON conforms to the schema — the workflow trusts the generation rules without a validate-and-fix loop.

4 / 5

Progressive Disclosure

Textbook structure: a short overview with all four references listed, each annotated with its content ("Read only what you need"), all files verified to exist in references/ at exactly one level deep with no nested references. Content is appropriately split — SKILL.md holds the workflow, references hold schemas and generation logic.

5 / 5

Total

17

/

20

Passed

Description

87%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: third-person voice, concrete actions with named output files, and an explicit multi-condition 'Use when' clause covering new projects, missing briefs, stage overrides, and redefinition. Minor room to expand action coverage and add a few more natural trigger synonyms.

DimensionReasoningScore

Specificity

Names concrete actions — "Guides the user through an interactive conversation" and "generates research_brief.json and tasks.json" — with specific output artifacts. Falls short of 5 because broader capabilities (stage selection, iteration/regeneration, summarizing existing state) are only implied through the trigger list rather than stated as actions.

4 / 5

Completeness

Explicitly answers both: what ("interactive conversation to define their research project, then generates research_brief.json and tasks.json") and when ("Use when starting a new project, when no research_brief.json exists, when the user wants to start from a specific pipeline stage, or when the user wants to redefine their research pipeline") with four concrete trigger conditions. Clearly matches the top anchor; the when-clause is fully explicit rather than implied.

5 / 5

Trigger Term Quality

Natural trigger phrases include "starting a new project", "start from a specific pipeline stage", and "redefine their research pipeline", plus the concrete file name research_brief.json. Not 5 because common variations like "plan my research", "set up tasks", or mentions of tasks.json as a trigger are missing.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (research pipeline planning) anchored by distinctive artifacts (research_brief.json, tasks.json, pipeline stages) unlikely to appear in unrelated skills. Trigger conditions are specific to this workflow, so misfiring on a generic 'project' skill is unlikely.

5 / 5

Total

18

/

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

OpenLAIR/dr-claw

Path

skills/inno-pipeline-planner/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.