CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-reflect

Mine completed ticket evidence for reusable factory improvements, propose narrowly routed skill or tooling changes, and compare candidates against a budget-aware evaluation set before human approval. Use after meaningful factory experience, not after every routine ticket.

Quality

81%

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

86%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 tight, well-structured instruction skill: lean prose, a concrete candidate checklist and routing table, explicit human-approval gates with validation/re-run steps, and exactly one verified, clearly signaled reference file carrying the evaluation detail. The only real gap is the absence of a worked example or concrete commands for the evidence-mining step.

DimensionReasoningScore

Conciseness

The ~50-line body is lean and directive throughout — "Never auto-apply a skill change", "Keep rejected ideas in the session rather than building a permanent backlog of noise" — with zero padding and no explanation of concepts Claude already knows. Every sentence adds a constraint or instruction, matching anchor 5.

5 / 5

Actionability

For an instruction-only skill the guidance is highly actionable: enumerated evidence sources, a five-field per-candidate record checklist, an explicit routing table (tooling / .factory/CONTEXT.md / .factory/FACTORY.json / narrowest existing skill / new skill), and a copy-paste Output template. It stays at anchor 4 because there are no concrete commands or a worked example showing how to mine tickets or fill in the template.

4 / 5

Workflow Clarity

The select → derive → evaluate → ask-user → apply sequence is unambiguous with real checkpoints: "Only after explicit approval may the relevant skill-authoring workflow edit the skill repository", "Validate changed skills and rerun affected evaluations", and the accept/revise/reject decision loop. It falls short of anchor 5 because the steps are prose sections rather than an explicitly numbered workflow, and key validation detail is delegated to the reference file instead of inline feedback loops.

4 / 5

Progressive Disclosure

The body is a concise overview that appropriately splits evaluation detail into a single well-signaled, one-level-deep reference ("Read [references/evaluation.md](references/evaluation.md)"), which exists in the bundle and points to no further nested files. Navigation is trivial and nothing that belongs in a separate file is inlined, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

67%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-constructed third-person description that clearly states multiple concrete capabilities and includes an explicit use-when boundary. Its main weakness is trigger coverage: users would more likely say "reflect", "retro", or "lessons learned" than the phrasing offered, and the when-clause lacks concrete trigger events.

Suggestions

Add natural trigger synonyms to the when-clause, e.g. "Use when the user asks to reflect, run a retrospective, or extract lessons learned from completed factory tickets".

Make the "when" concrete by naming the triggering events already in the body: "after a costly failure or correction, or when the same useful pattern appears across tickets".

Sharpen the capability objects slightly (e.g. "mine ticket evidence for general mechanisms" instead of the abstract "reusable factory improvements") to push specificity toward full coverage.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "Mine completed ticket evidence", "propose narrowly routed skill or tooling changes", and "compare candidates against a budget-aware evaluation set" — in third person with no filler. It falls short of anchor 5 because objects like "reusable factory improvements" remain abstract and coverage of what mining/evaluating concretely involves is not comprehensive.

4 / 5

Completeness

It explicitly answers both: the "what" (mine, propose, compare) and the "when" ("Use after meaningful factory experience, not after every routine ticket"). The when-clause is explicit but not anchored to concrete trigger events — e.g. "after a costly failure" or "when the same pattern repeats" — which keeps it at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Relevant domain keywords are present ("ticket", "factory", "skill", "tooling"), matching anchor 3, but natural user phrasings such as "reflect", "retrospective", "lessons learned", or "postmortem" are missing. It is above anchor 2 because the terms are domain-specific rather than generic, but below anchor 4 since several common variations a user would naturally say are absent.

3 / 5

Distinctiveness Conflict Risk

"Mine completed ticket evidence", "factory", and "budget-aware evaluation set" carve out a distinct retrospective niche with low trigger ambiguity. Minor overlap risk remains with skill-authoring skills via "propose narrowly routed skill… changes", placing it just below anchor 5's minimal-conflict bar.

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

geut/factory-skills

Path

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