CtrlK
BlogDocsLog inGet started
Tessl Logo

factory-plan

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

60

Quality

69%

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

A well-crafted instruction-only skill body: lean, direct, and dense with concrete operational details (exact calls, parameters, artifact paths, retry semantics), with a clear four-phase sequence and genuine feedback loops for the governed transition. The only trimmable fat is the Behavior Rules recap, and the only gap is the absence of example payloads for the transition call.

DimensionReasoningScore

Conciseness

The body is dense with directives and explains nothing Claude already knows — every phase carries operational content ("Write it to `.artifacts/plans/issue-<number>.md`", "rationale (max 1000 chars)"). It is not a 5 because the "Behavior Rules" section largely restates rules already established in the phases ("Verify, then plan" reprises Phase 1; "One terminal call" reprises Phase 4), a small amount of duplicated tokens that could be trimmed.

4 / 5

Actionability

Guidance is highly concrete for an instruction-only skill: named tool call (`factory_transition_work_item`), exact parameters (`stage: "execute"`, `expectedRevision` from the `factory-phase` signal, `rationale` max 1000 chars), an explicit artifact path, and an explicit prohibition ("Do not call `submit_plan`"). Not a 5 because there is no example of the transition call payload or a sample rationale, and the plan's verification commands are described but not exemplified — minor gaps rather than missing steps.

4 / 5

Workflow Clarity

Four clearly sequenced phases each carry explicit validation checkpoints — "Confirm the root cause and contributing areas against the code as it exists now", "Never build phases on unconfirmed claims" — and Phase 4 includes a full feedback loop: on rejection, "read the stated reason, address it (re-check the revision... rework the plan...), and retry once corrected." This matches the top anchor (clear sequence, explicit validation, error-recovery loop).

5 / 5

Progressive Disclosure

The skill is a single self-contained SKILL.md (~57 lines of body) with no bundle files in references/, scripts/, or assets/ and no need for them — per the judging guidelines, a sub-50-line skill with no external-reference need scores 5 on well-organized sections alone. Sections are cleanly headed (Phases 1-4, Behavior Rules) and the one path mentioned (`.artifacts/plans/`) is an output location, not a nested reference, so navigation is trivial.

5 / 5

Total

18

/

20

Passed

Description

53%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 concise, concrete, and third-person, clearly stating what the skill does in its Factory pipeline niche. Its main weakness is the complete absence of a "when to use" clause and of natural user-facing trigger terms, which caps both completeness and trigger quality. Adding an explicit trigger sentence with user-natural phrasing would raise it into the good-example range.

Suggestions

Add an explicit 'Use when...' clause (e.g. 'Use when a Factory work item is in the plan stage and needs an implementation plan before execution') to satisfy the completeness requirement.

Include natural trigger phrasing users would actually say — e.g. 'plan a Factory issue', 'move a work item to execute', 'implementation plan' — instead of relying solely on pipeline jargon like 'work item' and 'advance'.

Briefly enumerate the concrete deliverables (verified root cause, chosen approach with recorded assumptions, phased plan written to an artifact, transition to execute) to strengthen specificity from 1-2 actions to several.

DimensionReasoningScore

Specificity

The description names the domain ("Factory work item") and two concrete actions — "Produce a phased implementation plan" and "advance it to execute" — matching the 1-2-concrete-actions anchor. It is not a 4 because it omits the rest of the skill's coverage (verify understanding, design decisions, plan handoff structure), leaving minor-to-moderate gaps.

3 / 5

Completeness

The "what" is clear (produce a phased implementation plan, advance to execute), but there is no "Use when..." clause or any explicit trigger guidance for when to invoke the skill — per the judging guidelines this caps completeness at 3. It is not a 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant domain keywords exist ("implementation plan", "work item", "execute"), but they are pipeline jargon rather than the natural phrases a user would say, and no synonyms or variations are offered. Not a 4 because the natural-language triggers (e.g. "plan this Factory issue", "move a work item to implementation") are absent; not a 2 because the keywords are specific to the domain rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

The Factory-planning niche is mostly distinct — "Produce a phased implementation plan for a Factory work item, then advance it to execute" would rarely fire for unrelated skills. Not a 5 because the description shares the planning/implementation vocabulary with closely related pipeline skills (e.g. a triage or execute stage skill) without distinct trigger phrases to disambiguate.

4 / 5

Total

13

/

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
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.