CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-driven-evolve

Run the meta-loop — inspect and adapt the workflow itself. Probe the flow (constraint drift, rework hotspots, WIP theatre, decision starvation), the evidence (watermelon steps, checks that always pass, self-graded work), the delegation (rung mismatches, escalation droughts, context rot, platform stall), and the definition of workflow (policy contradictions, silent drift, measures nobody steers with) — then capture improvement bets with benefit hypotheses and kill criteria instead of changing anything on the spot. Use on the meta-loop cadence, after recurring findings, or when the board is clean enough to earn self-improvement. Loop 2 of the flow-driven family.

Quality

85%

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

82%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 lean, high-density instruction skill with a clearly sequenced workflow, concrete file artifacts and decision criteria, and well-signaled one-level references. The main gaps are that the referenced probe library and improvement-card template are not shipped in the bundle (with non-resolving path prefixes), and there is no fallback guidance for when the workspace data sources are missing.

Suggestions

Ship the four referenced files in the bundle and use skill-relative paths (references/loop-probes.md rather than skills/flow-driven/references/loop-probes.md), or inline a minimal probe checklist and improvement-card skeleton so the loop is executable from SKILL.md alone.

Add a fallback branch to step 2 for workspaces where board.md, flow-log.csv, or the improvement lane does not yet exist (e.g. 'no board yet — run only the definition-family probes and create the lane').

Include one compact worked example of a fired probe becoming an improvement card (signal, citation, benefit hypothesis, kill criteria) to make the capture step copy-paste concrete.

DimensionReasoningScore

Conciseness

Every section carries operational content — "Probes read data; they do not free-associate", "Three similar learnings count as a signal. A pass that fires nine probes produces a report nobody acts on" — with zero explanation of concepts Claude already knows and no padding across ~85 lines. Rationale one-liners like "edits made in passing are how operating models rot" justify rules in few tokens rather than over-explaining, so it sits at the 'lean and efficient' anchor rather than 4.

5 / 5

Actionability

Concrete guidance throughout: named data sources ("board.md, flow-log.csv, reviews/loop-log.md, learnings/", "measures.md baselines"), counts ("Run 3–5 probes"), artifact paths ("improvements/<slug>/improvement.md", "reviews/YYYY-MM-DD-meta-loop.md") with enumerated card fields, and a right-sizing mapping ("A policy tweak needs a line and a decision. A rung promotion needs a shadow run"). It is not 5 because the core probe definitions and the bet-card template are deferred to referenced files (loop-probes.md, templates/improvement.md) that are not present in the bundle, so a reader cannot execute the primary loop from this file alone.

4 / 5

Workflow Clarity

The eight steps are clearly ordered with data gathering before probing, per-probe decision criteria ("signal present? Cite the rows, items, or dates. No signal? One 'checked, quiet' line"), and a Quality Gates checklist verifying the end state ("Zero direct edits to workflow.md or step contracts in this invocation"). It is not 5 because there is no error-recovery feedback loop — e.g. what to do when board.md, flow-log.csv, or the improvement lane does not exist yet — leaving a gap between 'gather data' and 'run probes'.

4 / 5

Progressive Disclosure

Good structure: a compact overview body with a dedicated References section giving each file a one-line description ("loop-probes.md — the four probe families", "evolution-path.md — stages, human roles, the platform play"), all one level deep. It is not 5 because none of the four referenced files exist in the bundle (no references/ or templates/ directories) and the paths carry a 'skills/flow-driven/' prefix that will not resolve relative to SKILL.md, so step 1's "Load the probe library" points nowhere verifiable — more than a trivial organization gap, though the signaling itself is clear enough to sit above anchor 3.

4 / 5

Total

17

/

20

Passed

Description

81%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 dense, explicit description that clearly states both what the skill does (probe four families, capture improvement bets) and when to use it, with concrete trigger conditions. Its one weakness is trigger-term naturalness: most keywords are the skill family's internal jargon rather than phrases a user would spontaneously say, which caps discoverability by plain-language requests.

Suggestions

Add one or two plain-language trigger phrases users would naturally type (e.g. 'use when asked to improve or tune the workflow itself, run a retrospective on the process, or act on recurring findings') alongside the existing cadence-based triggers.

Soften or briefly gloss the internal jargon (e.g. 'watermelon steps (checks that pass green while work is red)') so the description is scannable by someone outside the flow-driven family.

DimensionReasoningScore

Specificity

"Probe the flow (constraint drift, rework hotspots, WIP theatre, decision starvation), the evidence (watermelon steps, checks that always pass, self-graded work), the delegation (rung mismatches, escalation droughts, context rot, platform stall)..." plus "capture improvement bets with benefit hypotheses and kill criteria" enumerate multiple concrete actions with named signals across all four probe families. It is not 4 because coverage is comprehensive for this skill's domain, not just 'several actions with minor gaps'; nothing is generic like 'Processes PDF files'.

5 / 5

Completeness

What is explicit: "Run the meta-loop — inspect and adapt the workflow itself... then capture improvement bets with benefit hypotheses and kill criteria instead of changing anything on the spot." When is explicit with concrete triggers: "Use on the meta-loop cadence, after recurring findings, or when the board is clean enough to earn self-improvement." Both anchor-5 conditions are met; it is not 4 because the 'when' clause is already specific rather than vague.

5 / 5

Trigger Term Quality

The only trigger phrasing is "Use on the meta-loop cadence, after recurring findings, or when the board is clean enough to earn self-improvement" — relevant but niche; the bulk of keywords ("WIP theatre", "watermelon steps", "escalation droughts", "rung mismatches") are internal family jargon a user would not naturally say. It is not 4 because natural variations users would actually type (e.g. 'improve the workflow', 'retrospective', 'tune the process') are missing, though it is above 2 since 'recurring findings', 'self-improvement', and 'workflow' are plausible user language.

3 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers ("meta-loop cadence", "the board is clean enough") and self-identification as "Loop 2 of the flow-driven family" minimizes conflict with unrelated skills. It is not 5 because the explicit family framing implies sibling loop skills in the same flow-driven family with overlapping vocabulary, i.e. minor overlap risk with closely related skills — the anchor-4 condition; it is well above 3 since no generic-skill collision is plausible.

4 / 5

Total

17

/

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

yyeret/portfolio-pdlc

Path

skills/flow-driven-evolve/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.