CtrlK
BlogDocsLog inGet started
Tessl Logo

factory-plan

Research and plan one ticket, producing a local plan, dependency-ordered task files, and only the durable context or ADR updates the ticket earns. Use before implementation when a feature, bug, refactor, performance task, or investigation needs to become executable work.

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

Low

Low-risk findings worth noting

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 well-engineered skill body: terse operational instructions, an explicit validation checklist with blocked-path feedback loops, and clean delegation of artifact formats to a single real reference file. The only notable improvements are eliminating the thrice-stated GitHub no-copy rule and making the fstate CLI path fully concrete.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept padding, every section gives operational instruction. It is not a 5 because the 'do not publish a second copy of a GitHub issue into .factory/tickets when GitHub is the ticket source' rule is stated three times (Start, the to-tickets bullet, and the Output section), which is trimmable redundancy.

4 / 5

Actionability

Mostly executable guidance: concrete commands ('git rev-parse --show-toplevel'), exact paths ('.factory/FACTORY.json', '.factory/tickets/<ticket-id>/'), named tool calls (caller_ping, subagent_resume), and a fully specified output template. Minor gaps keep it from 5: 'node …/factory-supervise/scripts/fstate/cli.mjs' has an elided path, and several integration steps depend on optional external skills and environment state.

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (Start → Resolve uncertainty → Build the plan → Validate and hand off → Output) with an explicit pre-finish validation checklist ('Before finishing, verify that: every success condition maps to at least one task acceptance criterion...') and genuine feedback loops (ask → waiting_for_user → subagent_resume; blocked status naming the unresolved decision). This matches the level-5 anchor.

5 / 5

Progressive Disclosure

The body is a clear overview that appropriately moves artifact file templates (plan.md, task files, adr.md formats) into a single real, one-level-deep reference, [references/artifacts.md](references/artifacts.md), referenced from clearly relevant sections. Navigation is easy and nothing is buried or nested, matching the level-5 anchor.

5 / 5

Total

18

/

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, well-structured description that explicitly covers both capability and trigger conditions in third person with concrete language. Its only weaknesses are slightly jargon-heavy phrasing ('ADR updates the ticket earns') and a few missing natural user phrasings for triggering the skill.

DimensionReasoningScore

Specificity

The description lists several concrete actions in third person ('Research and plan one ticket, producing a local plan, dependency-ordered task files, and only the durable context or ADR updates'), giving good coverage of the planning domain. It falls just short of the level-5 anchor because 'the durable context or ADR updates the ticket earns' is slightly opaque phrasing rather than plainly concrete actions.

4 / 5

Completeness

It clearly and explicitly answers both what ('Research and plan one ticket, producing a local plan, dependency-ordered task files...') and when ('Use before implementation when a feature, bug, refactor, performance task, or investigation needs to become executable work') with concrete trigger phrases, matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

It includes natural terms users would say when asking for this: 'plan', 'feature, bug, refactor, performance task, or investigation', 'before implementation'. Coverage is good but misses common phrasings like 'break down into tasks', 'make a work plan', or 'turn this ticket into actionable work', fitting the 'good keyword coverage; a few natural terms missing' anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (pre-implementation ticket planning producing plan.md and dependency-ordered task files) is mostly distinct with minimal overlap risk. However, 'Use before implementation' is broad enough to slightly overlap with generic implementation or scaffolding skills, so it fits the 'mostly distinct; minor overlap risk' anchor rather than a clear 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
geut/factory-skills
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.