CtrlK
BlogDocsLog inGet started
Tessl Logo

ux-agentico

UX agéntico Luana v4 (post pm-redesign 2026-05 Punto 4). Diseña FLUJOS CONVERSACIONALES (no UI tradicional) para agentic-stories state=refining. Toma 01-spec.md (de /po) y produce 02-design-agentic.md en docs/product/stories/{story-id}/ con: turn-by-turn happy path, state machine agente, tools sequence, prompt slot architecture, voice constraints, error recovery, eval policy (personas+rubrics+pass^k), cost/latency budget, observabilidad. Al ratificar diseño → transition state=refining→refined. Carga skills sales-agent-expert, copilot-expert, tessl__langgraph, claude-api. Si descubre edge cases → delta-spec.md → /po ratifica. Activa cuando user dice: '/ux-agentico', 'diseñemos el flujo conversacional', 'cómo conversa el agente', 'flujo del copilot', 'turn-by-turn', 'experiencia agéntica'.

75

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

88%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 strong, highly actionable workflow document: concrete templates at every step, explicit escalation and approval loops, and clear boundary rules. Its main weaknesses are localized redundancy (the engine/brand-extension split stated in two sections) and a length that slightly exceeds what a lean SKILL.md overview would carry, with some material better split into reference files.

Suggestions

Consolidate the engine-vs-brand-extension scope rules into one section — the split table near the top and the 'Anti cross-module pollution' section restate the same core/luana-core-* and backend/src/modules boundaries.

Move stable reference material (slot architecture examples, the /po-ux comparison table, error-recovery matrix template) into a references/ file and keep SKILL.md as the lean overview, per progressive disclosure.

Relocate dated context like 'Post single-project reorg 2026-05-15' into a deprecated/old-patterns note so time-sensitive scaffolding doesn't sit in the active guidance path.

DimensionReasoningScore

Conciseness

The body is dense and lean — tables, code-block templates, no explanations of concepts Claude already knows — but the engine-vs-brand-extension scope rules are stated twice (the split table at the top and again under 'Anti cross-module pollution'), and dated context like 'Post single-project reorg 2026-05-15' sits outside any deprecated/old-patterns section. Minor trimming instances keep it below the lean 5 anchor.

4 / 5

Actionability

Every step gives copy-paste-ready material: a turn-by-turn transcript example with real tool calls, an ASCII state machine, a tools table with concrete signatures and side-effects, a slot layout with TTLs and a forbidden-prefix list, an error-recovery matrix, an eval policy block, a cost budget, and a checkpoint YAML — fully executable guidance for an instruction-only skill.

5 / 5

Workflow Clarity

Thirteen clearly sequenced steps with scope validation up front (Step 1 checks the agentic_contract and escalates if unclear), explicit feedback loops (Step 12 'Loop hasta aprobación', Step 11 delta-spec → /po re-ratification), and a ratification checkpoint with state transition. Matches the anchor with explicit validation steps and error-recovery loops.

5 / 5

Progressive Disclosure

No bundle files exist, and the ~290-line body is well-sectioned with headers where every table/template is working guidance rather than bulk reference material. However, some reference-style content (slot architecture examples, the /po-ux comparison table) could live in separate files to keep SKILL.md a leaner overview — good structure with minor organization gaps.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: it states concretely what the skill produces (down to the artifact path and its nine sections), when to activate it with natural user-quoted trigger phrases, and how it differs from sibling UI skills. Third-person voice is used throughout; the only minor noise is the internal versioning prefix ('Luana v4 (post pm-redesign 2026-05 Punto 4)'), which adds no trigger value.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'Toma 01-spec.md (de /po) y produce 02-design-agentic.md ... con: turn-by-turn happy path, state machine agente, tools sequence, prompt slot architecture, voice constraints, error recovery, eval policy (personas+rubrics+pass^k), cost/latency budget, observabilidad' — covering the skill's full output comprehensively, matching the 'multiple specific concrete actions' anchor.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is concrete (designs conversational flows, produces 02-design-agentic.md with nine named sections, writes delta-spec.md, transitions story state) and the 'when' is explicit with concrete trigger phrases ('Activa cuando user dice: ...'). This matches the top anchor exactly.

5 / 5

Trigger Term Quality

It lists natural phrases a user would actually say plus the slash command: "Activa cuando user dice: '/ux-agentico', 'diseñemos el flujo conversacional', 'cómo conversa el agente', 'flujo del copilot', 'turn-by-turn', 'experiencia agéntica'" — comprehensive coverage including synonyms for the domain.

5 / 5

Distinctiveness Conflict Risk

'Diseña FLUJOS CONVERSACIONALES (no UI tradicional)' explicitly carves out a distinct niche from UI-design skills, and triggers like 'turn-by-turn' and 'flujo conversacional' are unlikely to fire for a standard CRUD/UI skill — a clear niche with minimal conflict risk.

5 / 5

Total

20

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
alpacapurpura/luana-method
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.