core-ux-detective

Identify and define core user tasks and journeys into a JSON model.

Updated Dec 19, 2025
One-click install
npx skills add https://github.com/Spectaculous-Code/raamattu-nyt --skill core-ux-detective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-ux-detective
Source: https://github.com/Spectaculous-Code/raamattu-nyt/tree/main/.claude/skills/core-ux-detective
Command: npx skills add https://github.com/Spectaculous-Code/raamattu-nyt --skill core-ux-detective

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill establishes the definitive list of user tasks and journeys within the application, serving as the single source of truth for user interaction models.

Core Features & Use Cases

  • Task Identification: Discovers and defines user-facing actions within the app.
  • Journey Mapping: Groups tasks into logical, ordered user paths.
  • Model Generation: Outputs a structured JSON model (core-user-model.json) for AI consumption.
  • Use Case: When developing a new feature, this Skill ensures it aligns with existing core user paths or formally defines new ones, maintaining a consistent UX model.

Quick Start

Use the core-ux-detective skill to identify and define all core user tasks and journeys.

Frequently Asked Questions about core-ux-detective

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

FAQPage Schema
How do I define core user journeys for my application?

To define core user journeys, you need to identify user-facing actions, group them into logical ordered paths, and generate a structured JSON model to serve as the definitive source of truth for user interactions.

What is a canonical user model and when do I need it?

A canonical user model is a structured JSON representation of defined user tasks and paths. You need it when mapping user capabilities or ensuring new features align with your established UX model.

How do I maintain a consistent UX model when adding new features?

Maintain a consistent UX model by mapping new features against existing core user paths and formally defining new tasks to update the definitive user interaction model.

Can I use an AI-readable user model for task analysis?

Yes, generating an AI-readable user model in JSON format provides a single source of truth for task analysis, enabling precise mapping of user capabilities and canonical journeys.

What is the best way to canonicalize user tasks and paths?

Canonicalize user tasks and paths by discovering user-facing actions, mapping them into logical ordered journeys, and outputting a structured JSON model for AI consumption.

Why does my feature alignment fail without a definitive user interaction model?

Feature alignment fails without a definitive user interaction model because there is no single source of truth to map user capabilities, leading to inconsistent user journeys and fragmented task definitions.