CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-flow-analyzer

Use this agent when you have a specification, plan, feature description, or technical document that needs user flow analysis and gap identification. This agent should be used proactively when:\n\n.

56

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/03-plan/spec-flow-analyzer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The body is a well-structured, instruction-only agent prompt with a clear phase sequence, concrete enumeration checklists, a defined output template, and good prioritization guidance. Its weaknesses are persona/motivational padding that inflates token cost without adding instruction, and the absence of any verification or self-check step in the workflow.

Suggestions

Cut the persona framing ("You are an elite..."), the mission list that duplicates the phases, and the closing motivational paragraph — the phase checklists already carry the instructions.

Add a lightweight self-check before output, e.g., 'Before writing the response, verify every flow listed in Phase 1 has permutations in Phase 2 and at least one gap or an explicit no-gap note in Phase 3.'

Consider moving the detailed output-format template (Flow Permutations Matrix, question fields) into a references/ file to keep SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The phase checklists are tight, but there is trimmable padding: the persona preamble ("You are an elite User Experience Flow Analyst and Requirements Engineer. Your expertise lies in..."), a 5-item mission list that duplicates the phases, and the closing motivational prose ("Be the advocate for the user's experience and the guardian against ambiguity"). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' — above the 'several padded sections' of 2, below the 'minor instances' of 4.

3 / 5

Actionability

For an instruction-only skill, the guidance is concrete: each phase enumerates specific dimensions to check ("First-time user vs. returning user", "Network conditions (offline, slow connection...)", "Undefined timeout or rate limiting behavior"), the output format is a fill-in template, and question quality is anchored by a worked example ("what should happen when the OAuth provider returns a 429 rate limit error?"). It stops short of 5 because much of the guidance is directive checklists rather than the fully worked, copy-paste-ready patterns of the top anchor.

4 / 5

Workflow Clarity

The four phases are clearly sequenced (Deep Flow Analysis → Permutation Discovery → Gap Identification → Question Formulation) and feed a defined output format with a prioritization scheme (Critical/Important/Nice-to-have). This is an analysis skill, so the destructive/batch validation cap does not apply; it misses 5 only because there is no explicit self-check step (e.g., verifying every mapped flow was covered before writing the output).

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single ~107-line file is well-sectioned with headers for each phase, output format, and key principles — good structure with content appropriately placed in one self-contained file. It is not 5 because at this length some material (e.g., the full output-format template or permutation matrix details) could be split into a referenced file to slim the always-loaded body.

4 / 5

Total

15

/

20

Passed

Description

62%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.

The description communicates a clear what/when pairing with a distinct niche, but is visibly malformed: the second sentence ends mid-clause ("...used proactively when:\n\n."), which truncates the trigger enumeration and reads as broken. Fixing that truncation and adding natural synonyms would lift trigger quality and completeness.

Suggestions

Repair the truncated second sentence — replace "This agent should be used proactively when:\n\n." with a complete trigger list (e.g., '...when the user shares a spec, requirements doc, PRD, or feature plan for review, or asks to find gaps, edge cases, or missing flows before implementation').

Add natural synonyms users actually say — 'spec', 'requirements', 'PRD', 'user stories', 'edge cases' — to broaden trigger coverage.

Optionally name one more concrete output (e.g., 'produces a prioritized list of clarifying questions and a flow matrix') to strengthen specificity.

DimensionReasoningScore

Specificity

The description names its domain ("specification, plan, feature description, or technical document") and exactly two concrete actions ("user flow analysis and gap identification"), matching the anchor for domain plus 1-2 concrete actions. It is not score 4 because no additional specific capabilities are enumerated, and not score 2 because the two actions named are concrete rather than generic.

3 / 5

Completeness

It has both a clear 'what' ("user flow analysis and gap identification") and an explicit 'when' ("Use this agent when you have a specification, plan, feature description, or technical document"), so it is not capped at 3. However, the 'when' is weakened by the broken dangling clause "This agent should be used proactively when:\n\n." whose trigger list was cut off, keeping it below the fully explicit score-5 anchor.

4 / 5

Trigger Term Quality

Relevant keywords exist ("specification", "plan", "feature description", "technical document", "user flow analysis", "gap identification") but common variations users would naturally say — "spec", "requirements", "PRD", "user stories", "edge cases" — are absent, and the second trigger sentence is literally truncated ("This agent should be used proactively when:\n\n."). This sits at 'some relevant keywords but missing common variations', below the 'good keyword coverage' of 4.

3 / 5

Distinctiveness Conflict Risk

"User flow analysis and gap identification" against specifications/plans is a fairly clear niche with distinct triggers, only overlapping minorly with general planning or code-review skills. It is not 5 because "technical document" is broad enough to invite some overlap with documentation-related skills, and not 3 because the core trigger pairing is specific and unlikely to fire for unrelated skills.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

marchatton/agent-skills

Path

.agents/skills/03-plan/spec-flow-analyzer/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.