CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-plan

Produce a phased implementation plan for a Factory work item, then advance it to execute

64

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./mastracode/factory/factory-skills/factory-plan/SKILL.md
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.

The body is a tightly written, well-sequenced workflow skill: concrete commands and tool parameters, explicit validation checkpoints with feedback loops for the governed transition, and clean single-file organization. Only minor trims (the recap-style Behavior Rules) and slightly thinner delegation of the triage pass keep it from full marks.

DimensionReasoningScore

Conciseness

The body is lean and imperative with essentially no explanation of concepts Claude already knows — commands and parameters are stated directly ("Run `git rev-parse --show-toplevel` and `git remote get-url origin`"). Minor trimmable redundancy exists: the Behavior Rules section recapitulates the Decision rule and Phase 1 ("Never build phases on unconfirmed claims" restates "Never plan against an understanding you haven't verified"), keeping it at anchor 4 rather than the every-token-earns-its-place level of anchor 5.

4 / 5

Actionability

Guidance is concrete and executable: exact git commands, the tool call name `factory_transition_work_item` with its parameters (`stage: "execute"`, `rationale` max 1000 chars), and a specific artifact path `.artifacts/plans/issue-<number>.md`. Minor gaps remain — the fresh-thread understanding pass is delegated to "as `factory-triage` does" without concrete steps, and no full example of the transition call is given — so it sits at anchor 4 rather than the fully copy-paste-ready level of anchor 5.

4 / 5

Workflow Clarity

The sequence is explicit (Repository Guard → Phase 1 verify → Phase 2 design → Phase 3 write plan → Phase 4 terminal transition) with validation checkpoints and feedback loops: the repository guard is re-run immediately before push, and a rejected transition triggers "read the stated reason, address it, ... retry once corrected". The Behavior Rules section functions as a checklist, matching anchor 5.

5 / 5

Progressive Disclosure

There are no bundle files, and this single-file skill (~68 lines of body) has no content that belongs in separate reference files: every section is a cohesive step of one workflow, well-organized with clear headers and no nested or buried references. Per the simple-skill exception, well-organized sections without external references warrant anchor 5.

5 / 5

Total

18

/

20

Passed

Description

66%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 is specific and well-targeted at the Factory planning stage, with concrete actions and natural trigger terms, but it lacks any explicit "when to use" guidance, capping completeness. Adding a trigger clause would lift it into the top tier.

Suggestions

Add an explicit trigger clause, e.g., "Use when a Factory work item reaches the planning stage and needs a phased plan before execution".

Include one or two natural user phrasings or synonyms (e.g., "plan the work item", "move it to the execute stage") to broaden trigger-term coverage.

Optionally mention a distinguishing capability (e.g., verifying the triage understanding before planning) to sharpen distinctiveness against sibling Factory phase skills.

DimensionReasoningScore

Specificity

The description lists two concrete, domain-anchored actions — "Produce a phased implementation plan for a Factory work item" and "advance it to execute" — which are specific rather than generic. It falls between anchor 3 (1-2 concrete actions, not comprehensive) and anchor 4 (several specific actions): the actions are noticeably more specific than anchor-3 examples like "Processes PDF files and extracts content", but coverage omits planning sub-activities (verification, assumptions), so it does not reach anchor 5.

4 / 5

Completeness

The "what" is clear and concrete, but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by the Factory context. This matches anchor 3 ("Has a clear 'what' but 'when' is missing or only weakly implied") and the judging guideline caps completeness at 3 for a missing trigger clause.

3 / 5

Trigger Term Quality

Terms a user would naturally say in the Factory context are present: "implementation plan", "Factory work item", "execute", "phased". Coverage is good but misses common variations and synonyms (e.g., "planning stage", "plan the work item", "move to build"), matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The phrase "Factory work item" plus the stage-advancement action carves a clear niche distinct from general planning skills; the only overlap risk is with sibling Factory phase skills (e.g., factory-triage, factory-execute). It is mostly distinct with minor overlap risk against closely related skills, matching anchor 4 rather than the minimal-conflict clarity of anchor 5.

4 / 5

Total

15

/

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

mastra-ai/mastra

Path

mastracode/factory/factory-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.