CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-driven-define

Define the workflow for a value stream by discovering it, deriving it, or adapting it — interview people about how work actually happens today and match it against archetypes; or, when no workflow exists, derive one from first principles and explain why working this way is worth it. Produces the unit of value, the steps and graph (branches, back-edges, sub-graphs), exit evidence per step, pull policies and WIP limits, classes of service, decision points, delegate and run model per step, and cadences. Use when standing up a new agentic workflow, surfacing an implicit one, or reworking a definition that no longer matches reality. Part of the flow-driven family.

Quality

84%

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-organized, opinionated instruction skill with concrete file targets, config keys, a linter checkpoint, and quality gates. The main gaps are an implicit (never explicit) validate-and-fix loop, no shown linter invocation or inline contract example, and inconsistent reference paths with template/linter files missing from the bundle and the References list.

Suggestions

Make the validation loop explicit in the Workflow section: after running flow_lint.py, add 'fix violations and re-run until zero' with the actual command invocation (e.g., 'python scripts/flow_lint.py workflow.md').

Harmonize reference paths — use one consistent prefix (either 'references/discovery-interview.md' or 'skills/flow-driven/references/discovery-interview.md') and give 'workflow-archetypes.md' its full path in the body.

Add templates/workflow.md, templates/step.md, and flow_lint.py to the References section (and ensure they exist in the bundle), and include one minimal inline example of a step contract (intent, exit_evidence, rung, run, escalation) so the deliverable shape is visible without opening the template.

DimensionReasoningScore

Conciseness

The body is dense and directive with almost no explanation of concepts Claude already knows; each section carries actionable guidance (path table, nine moves, rules with rationale). A few rhetorical asides could be trimmed — the STATIK provenance note ('which STATIK never had to') and flourishes like 'This move produces more argument than the other eight combined, which is the point' — keeping it at anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is concrete for an instruction-only skill: specific output files ('reviews/YYYY-MM-DD-workflow-discovery.md', 'steps/<id>.md'), config keys ('unit', 'unit_outcome', 'evidence_exits', 'decision_points'), a rung scale, and a linter ('flow_lint.py'). Minor gaps keep it below anchor 5: no invocation for flow_lint.py is shown, and there is no inline example of a step contract or workflow.md fragment — everything is delegated to template/reference files.

4 / 5

Workflow Clarity

The Workflow section gives a clear nine-step sequence with a validation checkpoint (step 8: run flow_lint.py and treat violations as design problems) and a Quality Gates checklist. The error-recovery loop (fix violations and re-run the linter) is implied but never explicit, and the linter is referenced without a command, fitting anchor 4 rather than the explicit feedback-loop anchor 5.

4 / 5

Progressive Disclosure

Structure is good: an overview body with an annotated, one-level-deep References section covering interview, first-principles, unit-of-value, schema, contracts, and archetypes files. Minor organization gaps: the body and the References section use inconsistent paths ('references/discovery-interview.md' vs 'skills/flow-driven/references/discovery-interview.md', bare 'workflow-archetypes.md'), and referenced files (templates/workflow.md, templates/step.md, flow_lint.py) are neither listed in References nor present in the bundle — anchor 4 rather than 5.

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: it explicitly states what the skill produces and when to use it, with concrete, domain-specific actions in third person. Its weaknesses are heavy internal jargon in the deliverables clause and missing natural synonyms that would broaden trigger matching.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions and outputs — 'interview people about how work actually happens today and match it against archetypes', 'derive one from first principles', and a comprehensive deliverables list ('unit of value, the steps and graph (branches, back-edges, sub-graphs), exit evidence per step, pull policies and WIP limits, classes of service, decision points, delegate and run model per step, and cadences') — in third-person voice. Coverage of the skill's outputs is comprehensive, matching the anchor-5 example rather than the minor-gaps anchor 4.

5 / 5

Completeness

Both questions are answered explicitly: a clear 'what' (three paths in plus the full list of produced artefacts) followed by an explicit 'Use when standing up a new agentic workflow, surfacing an implicit one, or reworking a definition that no longer matches reality.' This matches the anchor-5 example pattern of concrete what + explicit when-clause with multiple triggers.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'standing up a new agentic workflow', 'surfacing an implicit one', and 'reworking a definition that no longer matches reality' are present, but common synonyms a user might say ('document how work flows', 'map the process', 'process design') are missing and the deliverables clause is dense with internal jargon ('classes of service', 'cadences', 'pull policies and WIP limits'). Good coverage with a few natural terms missing fits anchor 4; anchor 5 requires comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The skill occupies a clear niche (workflow definition) within a named family ('Part of the flow-driven family') with triggers specific to definition work. However, generic 'workflow' keywords and the 'adapting it' path create minor overlap risk with closely related sibling skills (flow-driven-ingest, flow-driven-scaffold), fitting anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 3 missing

Warning

Total

15

/

16

Passed

Repository

yyeret/portfolio-pdlc

Path

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