CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-flow-architect

Interactive cross-feature navigation architect for Nicolify. Audits all routes and sidebar entries, maps user journeys across studios, detects orphaned features and dead-end flows, proposes navigation improvements with ASCII diagrams, generates clickable multi-page HTML prototypes on localhost:8888, and outputs FLOW-SPEC.md plus per-screen UI-SPEC updates for implementation agents. Use when the user asks about navigation coherence, user flows, journey mapping, orphaned features, dead-end screens, sidebar reorganization, cross-studio navigation, or feature discoverability. Triggers: 'flujo de usuario', 'navegación', 'journey', 'user flow', 'sidebar', 'rutas huérfanas', 'orphaned routes', 'dead end', 'flow audit', 'navigation audit', 'ux-flow', 'flow architect', 'cómo llega el usuario', 'discoverability', 'no encuentro', 'dónde está', 'reorganizar navegación', 'cross-feature flow', 'audita la navegación', 'mapa de rutas', 'flujos de la app'.

72

Quality

90%

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

82%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 dense, executable six-phase workflow with per-phase tool calls, confirmation gates, and templates properly externalized to reference files. Its main weaknesses are the contradictory deprecation banner versus the session-folder output rules, two referenced templates living outside the bundle, and some repetition of the session-folder rule.

Suggestions

Resolve the deprecation conflict: the top banner redirects outputs to `docs/projects/active/PI-N/sprints/SN/stories/{id}/mockups/` + `02-design-ui.md` while Phase 6 mandates `docs/ux-sessions/{SESSION_SLUG}/` — commit to one authoritative output path, or strip the legacy workflow entirely if the skill is truly absorbed by `/ux-ui` (workflow_clarity).

Vendor the two templates borrowed from ux-disruptivo (`ascii-mockup-guide.md`, `ui-spec-template.md`) into this skill's `references/`, or inline the minimal sections needed, so every referenced path resolves within the bundle (progressive_disclosure).

State the session-folder rule once: "Never write to `/tmp`, `docs/flow-specs/`, or `docs/ui-specs/`" appears twice and each Output A–D repeats a location the folder tree already declared (conciseness).

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no concept explanations, just tool lists, exact Globs, and tables — with templates correctly externalized. Not 5: the session-folder rule is stated three times ("Never write to `/tmp`, `docs/flow-specs/`, or `docs/ui-specs/`" appears in the Session Folder section and again in Phase 6, and each Output A–D repeats the location the folder tree already declared), so not every token earns its place. Not 3: there is no padded explanation of things Claude already knows, only minor repetition that could be trimmed.

4 / 5

Actionability

Fully copy-paste ready: exact Glob patterns ("frontend/src/app/(main)/[tenantId]/(dashboard)/**/page.tsx"), exact Read/Grep targets ("Read: frontend/src/components/shared/layout/app-sidebar.tsx"), executable bash ("mkdir -p \"docs/ux-sessions/$SESSION/prototype\"", "python3 -m http.server 8888 -d \"docs/ux-sessions/$SESSION/prototype/\""), and a concrete per-phase output format including an example ASCII journey diagram and sidebar before/after. Specific examples cover the common cases.

5 / 5

Workflow Clarity

A clear 6-phase sequence with tools per phase and explicit user-confirmation gates after each phase ("**Gate:** Present the map and ask...", "**Gate:** User confirms prototype reflects what they want"), plus Edge Cases and Common Mistakes tables. Not 5: the top deprecation banner ("Outputs nuevos van a `docs/projects/active/PI-N/sprints/SN/stories/{id}/mockups/`") directly contradicts the body's session-folder rule ("All outputs land in the session folder... `docs/ux-sessions/{SESSION_SLUG}/FLOW-SPEC.md`"), leaving the authoritative output destination ambiguous mid-workflow. Not 3: sequence and validation checkpoints are otherwise complete and explicit.

4 / 5

Progressive Disclosure

References are one level deep, clearly signaled, and loaded on demand at the right phase ("Load `references/journey-template.md`" in Phase 2, `navigation-patterns.md` in Phase 4, `html-prototype-system.md` in Phase 5, `flow-spec-template.md`/`ui-spec-template.md` in Phase 6), and all four in-bundle files exist with matching purpose. Not 5: two of the six referenced paths do not resolve inside this bundle ("`.claude/skills/ux-disruptivo/references/ascii-mockup-guide.md`" and `ui-spec-template.md` from ux-disruptivo), so they cannot be verified or loaded within the skill itself. Not 3: bulk material is properly split out and navigation to it is easy.

4 / 5

Total

17

/

20

Passed

Description

96%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 is exemplary: concrete end-to-end actions, an explicit use-when clause, and unusually thorough bilingual trigger coverage including natural user complaints. The only weakness is mild overlap risk on generic terms like 'sidebar'/'navegación' with closely related design skills.

DimensionReasoningScore

Specificity

"Audits all routes and sidebar entries, maps user journeys across studios, detects orphaned features and dead-end flows, proposes navigation improvements with ASCII diagrams, generates clickable multi-page HTML prototypes on localhost:8888, and outputs FLOW-SPEC.md plus per-screen UI-SPEC updates" — six concrete, verifiable actions covering the full audit-to-deliverable pipeline, matching the 'multiple specific concrete actions; comprehensive coverage' anchor. Not 4: coverage is end-to-end with no gaps of consequence.

5 / 5

Completeness

Explicit what ("Audits all routes and sidebar entries... outputs FLOW-SPEC.md plus per-screen UI-SPEC updates") followed by an explicit when ("Use when the user asks about navigation coherence, user flows, journey mapping, orphaned features, dead-end screens...") plus a dedicated trigger list. Clearly and explicitly answers both what AND when with concrete trigger phrases; the missing-'Use when' cap does not apply.

5 / 5

Trigger Term Quality

"Triggers: 'flujo de usuario', 'navegación', 'journey', 'user flow', 'sidebar', 'rutas huérfanas', 'orphaned routes', 'dead end', 'flow audit', 'navigation audit'... 'no encuentro', 'dónde está', 'reorganizar navegación'" — comprehensive natural phrasings with synonyms in both English and the user's actual language (Spanish), including how a frustrated user would literally ask ('no encuentro', 'dónde está'). Matches the 'comprehensive coverage of natural terms including synonyms' anchor; not 4 because nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

"Interactive cross-feature navigation architect for Nicolify" with niche triggers like "rutas huérfanas", "orphaned routes", "dead end", "flow audit" carves a clear role distinct from screen-designer skills. Not 5: broad triggers such as "sidebar", "navegación", and "discoverability" overlap with the sibling ux-disruptivo/ux-ui design skills (sidebar work could reasonably be screen design), so it is 'mostly distinct; minor overlap risk with closely related skills'. Not 3: the orphan/dead-end/flow-audit vocabulary is strongly distinctive of this skill alone.

4 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (533 lines); consider splitting into references/ and linking

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

alpacapurpura/ap_sales_agent

Path

.claude/skills/ux-flow-architect/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.