CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-driven-run

Advance a flow workspace agentically — validate the definition, regenerate the board, take the single highest-leverage move from the deterministic run card (overdue decision, broken contract, blocked item, missing exit evidence, ready-to-pull, over-WIP, aging, or intake), run that step under its contract, verify the exit evidence with something independent, and record the transition. Use to run a cycle, work the flow on a cadence, drive an item to its next decision, or operate the loop headlessly. Loop 1 of the flow-driven family.

Quality

94%

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

96%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 exceptionally tight operational protocol: every step is a command, a gate, or a recordable output, with validation and escalation paths explicit at each risky point. The only structural weakness is that the referenced context files are not present in the skill bundle and use project-root-relative rather than skill-relative paths.

Suggestions

Ship the three reference files (loop-engineering.md, step-contracts.md, workflow-definition.md) inside the skill's own references/ directory so the References section resolves when the skill is installed standalone.

Use bundle-relative paths (e.g., references/loop-engineering.md) instead of skills/flow-driven/references/... so the pointers survive being copied out of the source repo.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — commands like `flow_lint.py <ws>`, `flow_board.py <ws>`, `flow_next.py <ws>`, exact fields (`step`, `step_entered`, `holder`, `evidence_exits_met`), and exact report strings (`CYCLE-COMPLETE <rule> <slug>`). It never explains concepts Claude already knows; even the rhetorical one-liners ('a recorded "we could not" beats an invented "we did"') encode behavioral rules rather than padding. Not score 4 because there is no over-explanation to trim — every sentence changes what the agent does.

5 / 5

Actionability

Fully executable for an instruction-only skill: concrete commands with exit-code semantics ('Exit code 4 means the top move is a human decision'), exact file destinations (`reviews/loop-log.md`, `improvements/`, `learnings/`), exact fields to update, and explicit handling of the common cases (lint failure, wrong card, no declared verification, blocked item, over-WIP). Per the scoring notes, absence of code is not penalized when guidance is this actionable. Not score 4 because there are no missing key details the body itself owes — the contract-specific details are correctly delegated to the run card.

5 / 5

Workflow Clarity

The 9-step workflow has an explicit validation gate ('GATE: violations mean... fixing them is this cycle's move, and nothing else is'), an independent verification step with a skeptic's brief, error-recovery paths (escalation, back-edge, DECISION-PENDING), a re-projection step ('Re-run `flow_board.py` (it appends the transition)'), and a closing Quality Gates checklist. Not score 4 because validation checkpoints are explicit at every risky point, not implicit.

5 / 5

Progressive Disclosure

The References section is clearly signaled and one level deep, with a one-line purpose per file ('the six beats and why the leverage table is ordered the way it is'). However, the referenced paths (`skills/flow-driven/references/loop-engineering.md`, `step-contracts.md`, `workflow-definition.md`) are repo-root-relative and the bundle contains no `references/` directory, so the targets cannot be verified as real files and would not resolve if the skill were installed alone. Not score 5 because a well-signaled reference section only earns the top anchor when the referenced files are actually part of the bundle; not score 3 because the SKILL.md itself is a proper overview with nothing inlined that belongs in a separate file.

4 / 5

Total

19

/

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: third-person, concrete about the full action chain, with an explicit multi-trigger use-clause. It loses only marginal points on trigger synonym coverage and on inherent overlap risk with its named skill family.

DimensionReasoningScore

Specificity

The description enumerates the full concrete action chain — 'validate the definition, regenerate the board, take the single highest-leverage move from the deterministic run card..., run that step under its contract, verify the exit evidence with something independent, and record the transition' — and even itemizes the rule types (overdue decision, broken contract, blocked item, missing exit evidence, ready-to-pull, over-WIP, aging, intake). Not score 4 because coverage is comprehensive with no gaps in the run-cycle action set.

5 / 5

Completeness

Both halves are explicit: the 'what' is the detailed action chain (validate → project → select → run → verify → record), and the 'when' is a literal 'Use to run a cycle, work the flow on a cadence, drive an item to its next decision, or operate the loop headlessly.' Not score 4 because the when-clause is explicit, multi-trigger, and concrete — exactly the anchor-5 pattern of stating what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Good natural phrasing a user of this system would say: 'Use to run a cycle, work the flow on a cadence, drive an item to its next decision, or operate the loop headlessly.' Not score 5 because several heavy-jargon terms ('deterministic run card', 'exit evidence', 'over-WIP') dominate and a few natural synonyms ('advance the flow', 'do a flow step') are absent; not score 3 because the explicit use-clause supplies four distinct natural trigger phrases rather than a single keyword.

4 / 5

Distinctiveness Conflict Risk

The niche is clear ('Advance a flow workspace agentically', 'flow-driven family') and the use-clause triggers on run-cycle operation rather than authoring or evolving, which separates it from siblings like flow-driven-evolve. Not score 5 because it self-identifies as 'Loop 1 of the flow-driven family' — closely related sibling skills share the 'flow'/'loop' trigger surface, leaving minor overlap risk; not score 3 because the run-vs-evolve distinction is drawn by the triggers themselves.

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