CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

factory-lookback

Experimental workflow for auditing recurring feedback, telemetry, errors, and brittle delivery paths to find systemic fixes. Use for periodic or requested cross-source lookbacks, not routine single-item intake.

Quality

85%

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

81%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-structured, lean workflow skill with strong sequencing, explicit validation checkpoints, and feedback loops for a batch, evidence-gathering operation. Weaknesses are minor: some duplicated enumeration of policy-gated actions, a few abstract directives, and one prose-heavy section mixing three sub-workflows.

Suggestions

Break "Find the systemic cause" into labeled sub-steps (trace prior dispositions / re-triage held reports / reproduce a representative case) to remove the one unstructured prose section.

Deduplicate the list of policy-gated actions (reply, close, PR approval, merge, deploy, notify) — state it once and reference it from the Report checklist.

Make the boundary-fix directive concrete with a brief example (e.g., one validated fix at a shared API/service boundary vs. per-caller patches) so the instruction is copy-paste actionable.

DimensionReasoningScore

Conciseness

The body is dense, directive prose with zero explanation of concepts Claude already knows ("Do not report a complete lookback when coverage is partial"). It misses anchor 5 by one minor redundancy — the policy-gated action list (reply, PR approval, merge, deployment, notification) is enumerated in both "Change and verify" and "Report" — but has no unnecessary explanation, so anchor 3 does not fit.

4 / 5

Actionability

Concrete anchors are present ("Read `.agent-factory/config.yaml`", "`skill_prompts.factory-lookback`", "`workflows.lookback.implement`") alongside specific step directives (record source filters, dates, counts; follow every page or cursor). It is not anchor 5 because some directives stay abstract ("Prefer one verified correction at that boundary over a pile of caller-specific patches"), and not anchor 3 because the guidance is specific and executable rather than pseudocode-like.

4 / 5

Workflow Clarity

A clear phase sequence (Build evidence set → Find the systemic cause → Change and verify → Report) with explicit validation checkpoints and feedback loops: the coverage guard, re-triage on new replies with "Keep the item open when the answer is still incomplete", post-fix regression checks, signal re-inspection ("A test, merge, or 'fixed' label alone does not prove that the live recurrence stopped"), and a per-pattern report checklist. This is a batch/external-action workflow and validation is explicitly present, matching anchor 5.

5 / 5

Progressive Disclosure

The skill is self-contained with no bundle files, and the body is organized into clear section headers matching the workflow phases. It falls short of anchor 5 because the "Find the systemic cause" section packs three distinct sub-workflows (trace prior dispositions, re-triage held reports, reproduce representative cases) into unstructured prose — a minor organization gap — but anchor 3 does not fit since structure and navigation are good.

4 / 5

Total

17

/

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 strong description: concrete actions, explicit and negatively-bounded trigger guidance, and good keyword coverage in third-person voice. Main gaps are a couple of abstract phrases and missing common synonyms for the lookback concept.

Suggestions

Add one or two natural synonyms such as "retrospective" or "post-mortem" to the trigger phrasing so users searching with those terms match the skill.

Replace the abstract "brittle delivery paths" with a more concrete failure domain (e.g., "recurring CI or release failures") to sharpen specificity.

Clarify what "systemic fixes" means concretely (e.g., "root-cause fixes at a shared boundary") to lift specificity toward comprehensive coverage.

DimensionReasoningScore

Specificity

"auditing recurring feedback, telemetry, errors, and brittle delivery paths to find systemic fixes" lists several concrete actions and objects with only minor gaps. It falls short of anchor 5 because "brittle delivery paths" and "systemic fixes" remain somewhat abstract, but exceeds anchor 3 since more than 1-2 concrete actions are enumerated.

4 / 5

Completeness

The description explicitly answers both what ("auditing recurring feedback, telemetry, errors, and brittle delivery paths to find systemic fixes") and when ("Use for periodic or requested cross-source lookbacks, not routine single-item intake") with a concrete trigger phrase plus a negative boundary. This matches anchor 5 rather than 4 because the 'when' clause is already explicit and specific.

5 / 5

Trigger Term Quality

"recurring feedback", "telemetry", "errors", and "cross-source lookbacks" are natural phrases users would plausibly say, giving good keyword coverage. It is not anchor 5 because common synonyms like "retrospective", "post-mortem", or "incident review" are missing, and not anchor 3 because coverage is genuinely good rather than merely "some relevant keywords".

4 / 5

Distinctiveness Conflict Risk

The "not routine single-item intake" carve-out and the periodic cross-source framing establish a clear niche with mostly distinct triggers. It stops short of anchor 5 because auditing "feedback, errors, telemetry" could still overlap with routine debugging or triage skills.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

BuilderIO/skills

Path

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