CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

flow-driven

Turn any value stream — a PDLC, an SDLC, a content pipeline, an AI use-case pipeline, an operational request stream — into a flow-driven agentic loop that runs on plain files. Use when choosing where to apply agentic workflow, defining or ingesting a definition of workflow (steps, graph, exit evidence, delegate model per step, run model per step, measures), scaffolding it as markdown, orchestrating it agentically one move per cycle, integrating it with GitHub or a Kanban board, or inspecting and adapting the loop itself. Entry point and operating loop for the flow-driven-* skill family; for portfolio-level investment management use portfolio-pdlc instead.

Quality

89%

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

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-engineered orchestration body: an executable six-step loop with validation gates, a deterministic move-selection table, and clean delegation to 14 real reference files. Deductions come from undefined placeholders (REPO), a loop-log path inconsistent with the workspace layout, two referenced bundle paths that do not exist, and some rhetorical prose that could be tightened.

Suggestions

Resolve the two dead references: either add the templates/ and example/fiy-content-engine/ directories to the bundle or remove them from the References section (and the workspace layout code block).

Make the run loop self-consistent: define how to resolve <REPO>, and reconcile step 6's 'reviews/loop-log.md' with the layout's 'flow-log.csv' — pick one canonical loop-log location and list it in the workspace layout.

Reformat the workspace layout block one file per line with its role, and give the middot-packed reference line (workflow-archetypes.md · value-streams.md · ...) the same one-line descriptions the earlier references get.

DimensionReasoningScore

Conciseness

The body is dense and instructive with no padding of concepts Claude already knows, but rhetorical flourishes ("The name is the first commitment, said out loud", "only a clean board earns the luxury of self-improvement") and partial overlap between "Outcome" and "Outcome Indicators" could be trimmed. Not 3: every section carries operational content; not 5: some editorializing does not earn its tokens.

4 / 5

Actionability

Concrete, verified commands ("python3 <REPO>/skills/flow-driven/scripts/flow_lint.py <ws>" plus flow_board.py and flow_next.py, all present in scripts/) and named frontmatter fields to update ("step, step_entered, holder, evidence_exits_met"). Not 5: minor gaps — the <REPO> placeholder is never defined, "reviews/loop-log.md" in step 6 is missing from the workspace layout (which lists flow-log.csv instead), and the layout block crams two files per line, hurting scannability.

4 / 5

Workflow Clarity

The Run Loop is a clear six-step sequence with an explicit validation gate ("GATE: never steer with a broken definition of workflow — if it reports violations, fixing them IS this cycle's move"), verification "using something other than what did the work", a deterministic first-match-wins leverage table for move selection, and a closing Quality Gates checklist. Feedback loops, checkpoints, and error recovery (lint violations become the move) are all explicit. Not 4: no validation gaps remain.

5 / 5

Progressive Disclosure

The body is a well-organized overview with one-level-deep references, and all 14 individually named reference files exist in references/; scripts referenced also exist. Not 5: two referenced paths — "skills/flow-driven/templates/" and "skills/flow-driven/example/fiy-content-engine/" — are absent from the bundle, and the final reference line packs 8 files with middot separators and no per-file signaling, weakening navigation.

4 / 5

Total

17

/

20

Passed

Description

92%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 states a concrete transformation, enumerates six explicit use-when triggers, and disambiguates sibling skills. Its only weakness is that the trigger vocabulary skews toward the skill's internal jargon (exit evidence, delegate model, run model) rather than phrases a user would naturally say before knowing the method.

DimensionReasoningScore

Specificity

The description enumerates the full capability set — "defining or ingesting a definition of workflow (steps, graph, exit evidence, delegate model per step, run model per step, measures), scaffolding it as markdown, orchestrating it agentically one move per cycle, integrating it with GitHub or a Kanban board, or inspecting and adapting the loop itself" — concrete actions covering every capability in the skill's routing table. Not 4: there are no coverage gaps; each action is specific and comprehensive.

5 / 5

Completeness

Both what and when are explicit: what — "Turn any value stream ... into a flow-driven agentic loop that runs on plain files"; when — "Use when choosing where to apply agentic workflow, defining or ingesting ... scaffolding it as markdown, orchestrating it ... integrating it with GitHub or a Kanban board, or inspecting and adapting the loop itself", six concrete trigger situations. Not 4: the when-clause is already explicit and enumerated, not merely present.

5 / 5

Trigger Term Quality

Natural domain terms are present — "a PDLC, an SDLC, a content pipeline, an AI use-case pipeline, an operational request stream", "GitHub or a Kanban board" — but the when-clause leans on internal jargon ("exit evidence", "delegate model per step, run model per step", "one move per cycle") that users would not say before discovering the skill. Not 5: good coverage, but common phrasings such as "agile", "process", or "workflow automation" are absent.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (agentic loop engineering for value streams) with distinctive triggers, and explicitly disambiguates siblings: "Entry point and operating loop for the flow-driven-* skill family; for portfolio-level investment management use portfolio-pdlc instead." Minimal conflict risk. Not 4: the niche and its vocabulary are unique; no notable overlap risk with generic skills.

5 / 5

Total

19

/

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