CtrlK
BlogDocsLog inGet started
Tessl Logo

factory-work

Implement one dependency-ready ticket task in an isolated worktree using a small design sketch, behavior-first tests, the appropriate task playbook, and bounded verification. Use for the work stage after ticket planning.

71

Quality

89%

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

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 exemplary instruction-only skill body: a tightly sequenced implement-prove-report workflow with explicit validation checkpoints, concrete file paths, and a copy-paste output contract, with detail correctly pushed to a one-level-deep playbook reference. The only imperfection is minor elision in one command path and the absence of a worked manifest example.

DimensionReasoningScore

Conciseness

The body is dense, imperative directives with zero padding — "Implement one task. Keep the change no larger than the task's observable outcome requires." — and no explanation of concepts Claude already knows (no TDD tutorials, no git basics). Every line is either a directive, a boundary, or part of the required output contract, matching the lean anchor 5 rather than anchor 4 where trimming would still find fat.

5 / 5

Actionability

Guidance is highly concrete: exact file paths (`.factory/CONTEXT.md`, `.factory/evidence/<ticket>/<task>/manifest.json`), explicit manifest fields, a copy-paste output template, and exact status values (`ready_for_review`). It falls short of anchor 5 on small gaps: the state command is elided ("`node …/factory-supervise/scripts/fstate/cli.mjs`") and the manifest is specified by field list rather than by a worked example, but it is far above anchor 3's pseudocode level.

4 / 5

Workflow Clarity

The sequence is explicit and checkpointed: contract establishment with dependency/share gating, a numbered proving-slice loop that requires confirming the test "fails for the expected reason", explicit artifact proof ("A compile, typecheck, file timestamp, or self-report is not proof"), and an error-recovery loop ("If implementation repeatedly fights the sketch, stop... and redesign") plus plan-conflict escalation. This matches anchor 5's clear sequence with validation steps and feedback loops; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

The body is a concise orchestration overview that keeps the four task playbooks in a clearly signaled one-level-deep reference ([references/playbooks.md](references/playbooks.md), verified present) and delegates proof procedure to a single clearly linked sibling skill ([../prove-it-works/SKILL.md](../prove-it-works/SKILL.md)). The split is appropriate — the per-task playbook detail and verification procedure stay out of the main file, and the inline output template is the per-run contract, matching anchor 5.

5 / 5

Total

19

/

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 well-formed description that states a concrete what and an explicit, stage-anchored when with mostly distinctive pipeline vocabulary. Its only weaknesses are minor: a few missing natural trigger variations and no naming of the surrounding system that would make it fully collision-proof.

DimensionReasoningScore

Specificity

The description lists several concrete actions and artifacts — "Implement one dependency-ready ticket task in an isolated worktree using a small design sketch, behavior-first tests, the appropriate task playbook, and bounded verification" — which goes beyond the 1-2 actions of anchor 3. It stops short of anchor 5 because it does not enumerate the deliverables it produces (evidence manifest, status transitions, the structured result template), leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both questions: the 'what' is "Implement one dependency-ready ticket task in an isolated worktree..." and the 'when' is an explicit trigger clause, "Use for the work stage after ticket planning." The when clause is concrete and stage-anchored, matching anchor 5 rather than anchor 4 where the when is only weakly specific.

5 / 5

Trigger Term Quality

It carries good domain keywords a caller in this pipeline would naturally use: "ticket task", "worktree", "work stage", "ticket planning". It misses a few natural variations such as "implement", "build", or "coding stage", keeping it at anchor 4 rather than the comprehensive synonym coverage of anchor 5, but it is well above the sparse keyword sets of anchor 3.

4 / 5

Distinctiveness Conflict Risk

"dependency-ready ticket task", "isolated worktree", and "the work stage after ticket planning" carve out a clear pipeline niche that is unlikely to collide with planning or review skills. It sits at anchor 4 rather than 5 because the description never names the factory system itself, so a generic 'implement a task' skill in the same library presents minor overlap risk.

4 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

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.