CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

92%

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

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.

An exceptionally lean orchestration skill: a fully sequenced workflow with an explicit pre-finish validation checklist, concrete commands/paths/fields throughout, and a clean two-file reference layer that keeps the body compact. The single weakness is minor — a handful of rules are repeated across sections and could be consolidated into one statement.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and assumes Claude's competence — no concept explanations, no filler. It falls short of 5 only because a few rules are stated twice (the GitHub second-copy rule appears in both Start and Output, and the no-commit rule is restated after the validation checklist), which could be consolidated.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: exact commands (`git rev-parse --show-toplevel`), exact paths (`.factory/FACTORY.json`, `.factory/tickets/<ticket-id>/`), exact frontmatter fields (`type`, `qa`, `blocked_by` with their allowed values), named tools and calls (`grill-with-docs`, `caller_ping`, `subagent_done`), and templates in references. Per the scoring notes, the absence of code is not penalized since every instruction is concrete.

5 / 5

Workflow Clarity

The sequence (Start → Resolve uncertainty → Build the plan → Validate → Output) is explicit, and 'Validate and hand off' is an eight-item verification checklist (criterion mapping, acyclic dependencies, no speculative work, no commits) that gates finishing. It is not 4 because validation is explicit and error-recovery paths are covered — the caller_ping/waiting/resume loop and the 'if it replies that the session is shutting down, stop' handling — and not lower because the skill's operations are explicitly non-destructive (no commit/push/merge).

5 / 5

Progressive Disclosure

The ~60-line body is a clear overview that delegates templates and output format to two well-signaled markdown links, [references/artifacts.md](references/artifacts.md) and [references/output.md](references/output.md), both of which exist and point no deeper — one level of nesting exactly. Verified against the actual bundle listing, the split is appropriate: artifact and template detail lives in references while the body keeps the workflow.

5 / 5

Total

19

/

20

Passed

Description

88%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 that pairs concrete, artifact-level capabilities with an explicit 'Use before implementation when...' trigger clause covering all common task types. The only weaknesses are minor: a few natural synonym phrasings are missing and the broad task-type enumeration leaves slight overlap risk with adjacent planning/spec skills.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete outputs — 'producing a local plan, dependency-ordered task files, and only the durable context or ADR updates the ticket earns' — which comprehensively covers the skill's deliverables without generic filler. It sits at the comprehensive anchor rather than 4 because no meaningful capability of the planning flow is left unlisted.

5 / 5

Completeness

It explicitly answers both questions: 'Research and plan one ticket, producing...' (what) and 'Use before implementation when a feature, bug, refactor, performance task, or investigation needs to become executable work' (when, with concrete trigger conditions). This matches the anchor that requires both what and when with concrete trigger phrases, not the 4-anchor where the 'when' is only loosely specified.

5 / 5

Trigger Term Quality

The trigger clause names natural task-type keywords users actually say — 'a feature, bug, refactor, performance task, or investigation' — plus 'before implementation'. It falls short of 5 because common phrasings users might use ('plan this feature', 'break this down into tasks', 'spec') are absent.

4 / 5

Distinctiveness Conflict Risk

The niche is well carved — 'one ticket', 'dependency-ordered task files', 'ADR updates' distinguish it from generic helpers. It does not reach 5 because 'research and plan' plus the broad task-type list could overlap with closely related spec/ticket-writing skills when a user asks generically to 'plan' work.

4 / 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

geut/factory-skills

Path

skills/factory-plan/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.