CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-driven-instrument

Decide what a workflow should measure and wire it in — flow measures (WIP, age, cycle time, throughput, rework), evidence measures (coverage, first-pass yield, escape rate, check agreement), leverage measures (delegate mix, human minutes per item, escalation rate, cost per item), and the outcome measure the stream exists for — with each measure named on the steps that feed it and a baseline taken before anything changes. Use when defining a workflow, when a board has numbers nobody steers with, or before making any workflow-improvement bet. Part 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

75%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-built instructional skill body: lean, opinionated, concretely wired into named files and a lint guard, with a clear sequence and a quality-gate checklist. The remaining gaps are small — an explicit lint-failure recovery loop, a concrete `flow_lint.py` invocation, and verifiable bundle-relative reference paths.

Suggestions

Give `flow_lint.py` a concrete invocation (path and command line) and add an explicit recovery step: what to do when the lint fails on an undeclared measure.

Make the reference paths bundle-relative and verifiable (e.g., `references/measurement.md`, `templates/measures.md`) so the cited files resolve from the skill directory.

Flesh out step 9's watermelon check with the concrete procedure (which item to pick, where to record the finding) so it is executable rather than directional.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — it never explains what WIP or cycle time is, and each step is a directive with a one-line rationale ('An improvement bet without a baseline is a story with a number in it'). It sits at 'efficient with minor instances that could be trimmed' rather than 5 because the aphoristic asides and some repetition across Workflow steps, Rules, and Quality Gates (baselines and the four families each appear in multiple sections) could be tightened slightly.

4 / 5

Actionability

Concrete, executable guidance dominates: 'Add ids to the `measure-set` island in `measures.md` and to each step's `measures:`. Run `flow_lint.py`' names exact files, fields, and a lint tool, and each step specifies verifiable outputs. It falls short of fully copy-paste-ready because `flow_lint.py` is never given an invocation path or command line, and the watermelon check (step 9) describes intent without a concrete procedure.

4 / 5

Workflow Clarity

The nine steps form a clear, well-ordered sequence (decisions → families → outcome → steering/watch split → wiring → sources → baselines → refusals → scheduled check) with an explicit validation checkpoint ('Run `flow_lint.py` — it fails on a step naming a measure nobody declared') and a Quality Gates checklist. It does not reach 5 because there is no explicit error-recovery loop (what to do when the lint fails) and the gates are stated as conditions without a fix-and-recheck cycle.

4 / 5

Progressive Disclosure

The body is a genuine overview (~65 lines) and the References section lists three files, each with a one-line description and one-level-deep signaling ('`skills/flow-driven/references/measurement.md` — the four families, the anti-measures...'). It misses 5 because the referenced paths are repo-relative rather than bundle-relative (`references/measurement.md`) and none of the referenced files exist in this skill's bundle, so navigation cannot be verified from the skill itself.

4 / 5

Total

16

/

20

Passed

Description

88%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, third-person, comprehensive on capabilities, and with an explicit, multi-trigger 'Use when' clause. The main improvements are adding user-natural synonyms (metrics, KPIs) and clarifying what makes this skill distinct from its flow-driven siblings.

Suggestions

Add natural synonyms users would actually say — 'metrics', 'KPIs', 'dashboard numbers' — to the trigger clause alongside 'workflow' and 'measures'.

Since 'Part of the flow-driven family' implies sibling skills sharing the workflow trigger space, add a phrase that distinguishes this skill (e.g., 'the instrumentation step: deciding and wiring in measures') to reduce overlap risk with other family skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities with named measures per family — 'flow measures (WIP, age, cycle time, throughput, rework)', 'evidence measures (coverage, first-pass yield, escape rate, check agreement)', 'leverage measures (delegate mix, human minutes per item, escalation rate, cost per item)' — plus concrete wiring actions ('each measure named on the steps that feed it and a baseline taken before anything changes'). This matches the comprehensive-coverage anchor; it is not level 4 because there are no meaningful coverage gaps in what the skill does.

5 / 5

Completeness

It explicitly answers both questions: what it does ('Decide what a workflow should measure and wire it in' with the enumerated families and wiring/baseline behavior) and when to use it ('Use when defining a workflow, when a board has numbers nobody steers with, or before making any workflow-improvement bet'). This matches the anchor with concrete trigger phrases; a lower score would require a missing or only weakly implied 'when', which is not the case.

5 / 5

Trigger Term Quality

Triggers like 'Use when defining a workflow, when a board has numbers nobody steers with, or before making any workflow-improvement bet' give good natural phrasing, and terms like 'cycle time', 'throughput', 'baseline' are words users would say. It falls short of the comprehensive anchor because common synonyms such as 'metrics', 'KPIs', or 'dashboard' are absent and several terms (e.g., 'check agreement', 'escape rate') are internal jargon rather than user-spoken phrases.

4 / 5

Distinctiveness Conflict Risk

The measurement/instrumentation focus with triggers like 'a board has numbers nobody steers with' carves a mostly distinct niche with minor overlap risk. It does not reach 5 because 'Part of the flow-driven family' signals sibling skills in the same family that share the broad 'workflow' trigger space, and the description does not say what distinguishes this skill from those siblings.

4 / 5

Total

18

/

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