experience-design

Generates a signed experience design definition covering platform intent, user journeys, motion, and accessibility baseline.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/tektonlabs/ai-software-design --skill experience-design-tektonlabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: experience-design
Source: https://github.com/tektonlabs/ai-software-design/tree/main/.claude/skills/experience/experience-design
Command: npx skills add https://github.com/tektonlabs/ai-software-design --skill experience-design-tektonlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump from functional requirements straight into architecture and backlog without ever defining how the product should feel and behave, leaving navigation, platform choices, and accessibility commitments to be invented later by developers. This Skill produces a definition-level Experience Design document that binds those decisions before requirements are quantified. ## Core Features & Use Cases - Structured Experience Definition: Generates a 13-section document covering information architecture, application shell, platform definition, creative direction, key user journeys, motion system, view state matrix, and a WCAG accessibility baseline. - Calibration Dials: Classifies the product archetype (data-dense tool, transactional app, content surface, consumer mobile) and sets VISUAL_DENSITY, MOTION_INTENSITY, and DESIGN_VARIANCE so later decisions stay consistent. - Traceability & Gating: Every screen gets an XD-S-XXX ID traced to functional requirements, every journey traces to a use case, and the document is blocked until the Functional Spec is signed and validated against 20 rules before Solution Architect sign-off. - Use Case: After signing a Functional Requirements Specification for a field-technician mobile app, run this Skill to define offline-capable platform intent, the screen map, and the WCAG 2.2 AA baseline that Phase 4 will turn into measurable NFRs. ## Quick Start Ask the agent to run the experience-design skill to define the product experience for the current project once the functional spec is signed.

Frequently Asked Questions about experience-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define product experience before writing requirements?▼

Run this Skill after the Functional Requirements Specification is signed. It produces an Experience Design Definition covering platform intent, screen map, key journeys, motion system, and accessibility baseline that Phase 4 turns into measurable NFRs.

What does the experience design document include?▼

Thirteen sections: context of use, information architecture with a Mermaid navigation model, platform definition, creative direction, key user journeys, signature interaction, motion system, view state matrix, usability and accessibility baseline, design system foundations, scope, traceability, and document control.

When should I skip the experience design phase?▼

Skip only when the product has no human interface at all, such as a pure batch job, a library, or an internal API with no console. The skip and its reason must be recorded in project-config.md.

Does this skill produce visual mockups or final designs?▼

No. It operates at definition level, not visual detail. It records decisions that are expensive to reverse, such as platform targets and accessibility commitments, but excludes pixel-perfect mockups, final copy, and production CSS.

Why is the experience design skill blocked from running?▼

The Skill requires the Functional Spec to be signed first. Validation rule 1 blocks execution with the message that functional-spec is not signed yet, since journeys and screens must trace to approved FR-XXX and UC-XXX identifiers.