Agent skill

Design Discovery

by Owl-Listener in Owl-Listener/designpowers

You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour.

MITAuto-check passedFrontend & Design

Install Design Discovery

skills CLI
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Owl-Listener/designpowers design-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/design-discovery .claude/skills/design-discovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
design-discovery
GitHub stars
251
Token cost
~2.1k tokens
SKILL.md length
1,117 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour.

  • Works in 8 steps: Understand the Context → Explore Intent → Identify the Ability Spectrum → …
  • Tasks that involve Architecture decision records
  • SKILL.md covers Welcome Gate, The Rule, Discovery Modes and Process, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Design Discovery is an agent skill from Owl-Listener/designpowers. You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour. Explores intent, constraints, users, and context before any design decisions are made

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Architecture decision records. The repository describes itself as: An agent design team you control: 10 agents that run an inclusive design process while you direct. The licence is MIT.

When your agent uses it

  • Tasks that involve Architecture decision records

Example prompts

  • “/design-discovery”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Understand the Context
  2. Explore Intent
  3. Identify the Ability Spectrum
  4. Propose Approaches
  5. Write the Design Brief
  6. User Approval
  7. Create Design State
  8. Transition

What it can do on your machine

Read from SKILL.md and the folder at commit cb00757. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Design Discovery loads about 2.1k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 1,117 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Owl-Listener/designpowers at commit cb00757, republished under its MIT licence (© Owl-Listener). 1,117 words, ~2,068 tokens.

Download SKILL.mdSave it as .claude/skills/design-discovery/SKILL.md (or your agent's skills folder).
name
design-discovery
description
You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour. Explores intent, constraints, users, and context before any design decisions are made

Design Discovery

Discovery is where design begins. Before pixels, before wireframes, before any visual decisions — understand the problem. This skill ensures you never design the wrong thing well.

Welcome Gate

BEFORE running discovery, check whether the Designpowers welcome sequence has been shown this session. If the user has not yet seen the welcome (the bird, the greeting, and the walkthrough offer), you MUST invoke the using-designpowers skill FIRST and complete the welcome sequence before returning here. The bird must appear before any work begins. No exceptions.

The Rule

DO NOT proceed to any design, UI, or implementation work until discovery is complete and the user has approved the design brief.

Discovery Modes

Quick Discovery (for POCs and small tasks)

When the user says "proof of concept", "POC", "quick", "small", or the task is clearly exploratory:

  1. Keep it light. Ask a few essentials in a conversational way — not as a numbered checklist:

    "Quick version: what's the problem, who's it for, and what does success feel like? If you've got a design system or any references you love, throw those in too."

  2. Write the brief immediately from their answers — don't ask follow-up rounds
  3. Present the brief for approval in one block (not section by section)
  4. Create design-state.md in the project root immediately after brief approval

Quick discovery should take one user message of answers, not three. But the question should still feel like a person asking, not a form.

Full Discovery (for products and complex tasks)

When the task is a full product, involves multiple stakeholders, or the user explicitly wants depth — use the full process below.

Process

Step 1: Understand the Context

Before asking questions, gather what already exists:

  • Read any existing design documents, specs, or briefs in the project
  • Check for an existing design system, component library, or style guide
  • Look at the current state of what the user is working on
  • Identify the platform, tech stack, and any constraints
Step 2: Explore Intent

Have a conversation, not an interrogation. The goal is to understand what the user wants to build and why — but the tone should feel like two people talking, not a form being filled out.

Start with an open invitation, not a structured question:

"Tell me about what you're building. What's the story behind it?"

Let the user talk. Listen for the answers to these questions in what they say, and only ask follow-ups for what's missing:

  1. What problem are we solving? Not what feature are we building — what human problem does this address?
  2. Who experiences this problem? Not "users" — which specific people, in what situations, with what abilities and constraints?
  3. What does success look like? How will we know this design works? What changes for the person using it?
  4. What constraints exist? Technical, timeline, brand, accessibility requirements, regulatory
  5. What has been tried before? What worked, what failed, what was learned

Ask follow-ups ONE AT A TIME. Don't list all missing items at once. Pick the most important gap, ask about it conversationally, and repeat. Frame questions around what they've already told you:

  • Instead of "What are your constraints?" → "You mentioned it needs to work on mobile — any other constraints I should know about?"
  • Instead of "Who are the users?" → "You said it's for busy parents — tell me more about their typical day when they'd use this."

Weave in taste seeds naturally. Don't make these a separate section — fold them into the conversation when the moment feels right:

  • "Do you have a design system or style guide we should work within?"
  • "Any products or experiences you admire that have the feel you're going for?"
  • "How should this feel to use? (calm, playful, premium, effortless — whatever comes to mind)"

These are lightweight prompts, not the full taste calibration — that comes later via design-taste. But getting the user thinking about feel early means they arrive at taste calibration with sharper instincts. If they share a design system here, note it in the brief for the taste skill to pick up.

Acknowledge what they tell you. Before asking the next question, briefly reflect back what you heard. This shows you're listening and gives the user a chance to correct misunderstandings early:

"So this is about reducing no-shows for a small clinic — the receptionist is spending half their day on reminder calls. Got it. Who else is affected by this beyond the receptionist?"

Show full SKILL.md (386 more words)Show less
Step 3: Identify the Ability Spectrum

For every design task, explicitly consider:

  • Who might use this with a screen reader?
  • Who might use this with limited motor control?
  • Who might use this under cognitive load or stress?
  • Who might use this in a language that is not their first?
  • Who might use this with low vision, colour blindness, or in bright sunlight?

This is not a checklist to rush through. These are real people who will use what you build.

Step 4: Propose Approaches

Present 2-3 design approaches with clear trade-offs:

For each approach:

  • What it is — one sentence
  • Why it might work — the strengths
  • What it sacrifices — the trade-offs
  • Who it serves best — and who it might underserve
  • Accessibility implications — what inclusive design considerations arise
Step 5: Write the Design Brief

Once the user has chosen a direction, write a design brief:

markdown
# Design Brief: [Feature/Component Name]

## Problem Statement
[What problem are we solving, for whom, in what context]

## Users
[Who this serves — including ability spectrum considerations]

## Design Direction
[The chosen approach and why]

## Constraints
[Technical, timeline, brand, accessibility, regulatory]

## Existing Design System
[Path to design system, style guide, or component library — or "None"]

## Taste Direction (Early Signal)
[Any references, feelings, or aesthetic preferences the user shared during discovery. This seeds the full taste calibration later.]

## Success Criteria
[How we will know this works]

## Out of Scope
[What we are explicitly NOT doing]

Save to: docs/designpowers/briefs/YYYY-MM-DD-<topic>.md

Step 6: User Approval

Present the brief to the user section by section — not all at once. Get approval on each section before moving to the next. The user must explicitly approve the complete brief before any design work begins.

Step 7: Create Design State

This step is mandatory. Do not skip it.

Immediately after brief approval, create design-state.md in the project root with:

  • Brief summary (problem, primary persona, success metric)
  • Design principles (if defined during discovery)
  • Empty decisions log, open questions, artefact index, and handoff chain
  • Link to the full brief document

This file is the shared context every agent reads. If it does not exist, the pipeline cannot run.

Step 8: Transition

After approval and design state creation, invoke the appropriate next skill:

  • If research is needed → invoke research-planning
  • If the direction is clear → invoke design-strategy or writing-design-plans
  • NEVER skip directly to UI work

Integration

  • Called by: using-designpowers (auto-triggered on any design task)
  • Calls: research-planning, design-strategy, or writing-design-plans
  • Never skip to: ui-composition, interaction-design, or any implementation skill

Red Flags

FlagResponse
"Just make it look like this reference"References inform — they do not replace discovery. Ask what about the reference works and why
"We already know what we want"Great. Then discovery will be fast. But still do it — assumptions are where bad design hides
"This is just a small change"Small changes to interfaces affect real people. Discovery scales to the task — it does not get skipped

© Owl-Listener, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/design-discovery of Owl-Listener/designpowers.

Open the folder on GitHubat commit cb00757

Compare with similar skills

Design Discovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Design Discovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Design Discovery this skillOwl-Listener/designpowers251—~2.1kAutomated safety check: PassMIT
Coding Styleaws-samples/sample-multi-agent-orchestration-chat-on-agentcore130—~1.2kAutomated safety check: PassMIT-0
Architectdralgorhythm/claude-agentic-framework125—~475Automated safety check: PassNone
Idea Superpowers SuiteAkoliteZA/hermes-agent-idea-workflow272—~3.9kAutomated safety check: PassMIT
Typeui Fundamentalsbergside/typeui2k—~861Automated safety check: PassMIT
Design TrackerDeL-TaiseiOzaki/claude-code-orchestra199—~2kAutomated safety check: PassMIT

Similar skills

  • Coding Style

    aws-samples/sample-multi-agent-orchestration-chat-on-agentcore

    Official

    Design decisions, implicit rules, and anti-patterns for the Moca project.

    130 GitHub stars~1.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Architect

    dralgorhythm/claude-agentic-framework

    Design systems and record architecture decisions as ADRs — a user-invoked Principal Architect workflow.

    125 GitHub stars~475 tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Idea Superpowers Suite

    AkoliteZA/hermes-agent-idea-workflow

    A skill your agent uses when running the full idea workflow: capture a rough idea, expand it into design/UI/implementation docs, research similar products, and generate build-ready Markdown artifacts.

    272 GitHub stars~3.9k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed
  • Typeui Fundamentals

    bergside/typeui

    Universal UI/UX design principles covering visual hierarchy, interaction laws, typography foundations, and WCAG accessibility requirements.

    2k GitHub stars~861 tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Design Tracker

    DeL-TaiseiOzaki/claude-code-orchestra

    Record a project design decision into .claude/docs/DESIGN.md through the shared typed writer.

    199 GitHub stars~2k tokensUpdated 20 days ago
    DevelopmentAuto-check passed
  • Idea To UI Design Brief

    AkoliteZA/hermes-agent-idea-workflow

    A skill your agent uses when turning a product/design doc into a focused UI design brief, optional AI image-generation concept prompts, and implementation-ready UI direction without replacing the…

    272 GitHub stars~2k tokensUpdated 5 mo ago
    Frontend & DesignAuto-check passed

More from Owl-Listener/designpowers

All 33 skills in this repo
  • Adaptive Interfaces

    Owl-Listener/designpowers

    A skill your agent uses when designing for user preferences — motion sensitivity, contrast needs, colour schemes, text sizing, information density, or any interface behaviour that should adapt to…

    251 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Design Debate

    Owl-Listener/designpowers

    A skill your agent uses when a design direction is uncertain, when the team could go multiple ways, or when the user wants to see competing approaches argued before committing — orchestrates…

    251 GitHub stars~2.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Design Debt Tracker

    Owl-Listener/designpowers

    A skill your agent uses when critique or review produces deferred findings, when checking accumulated design compromises, or when deciding what to address in the next iteration.

    251 GitHub stars~2.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Design Handoff

    Owl-Listener/designpowers

    A skill your agent uses when design work is complete and needs to be communicated to engineering — creates specifications, documents rationale, accessibility requirements, and interaction details in…

    251 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Design Review

    Owl-Listener/designpowers

    A skill your agent uses when the user wants to evaluate something that ALREADY EXISTS rather than build something new — "review this", "audit this screen", "what's wrong with this page", "is this…

    251 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Design State

    Owl-Listener/designpowers

    A skill your agent uses when any Designpowers agent starts work or completes work — maintains the shared design state file that all agents read from and write to.

    251 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Design Discovery

What does Design Discovery do?

You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour. Design Discovery is an agent skill from Owl-Listener/designpowers. You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour.

When should I use Design Discovery?

Design Discovery fits situations like: tasks that involve Architecture decision records.

How do I install Design Discovery in Claude Code?

Run `npx skills add Owl-Listener/designpowers --skill design-discovery -a claude-code`. Or copy the skill folder (skills/design-discovery in Owl-Listener/designpowers) into .claude/skills/design-discovery in your project. Claude Code loads it when a task matches its description.

How do I install Design Discovery in Codex?

Run `npx skills add Owl-Listener/designpowers --skill design-discovery -a codex`. Or copy the skill folder (skills/design-discovery in Owl-Listener/designpowers) into .agents/skills/design-discovery in your project. Codex loads it when a task matches its description.

Can I use Design Discovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Owl-Listener/designpowers --skill design-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/design-discovery, .gemini/skills/design-discovery, .github/skills/design-discovery and .opencode/skills/design-discovery in your project.

What does Design Discovery need to run?

SKILL.md names no scripts, command-line tools or credentials: Design Discovery is instructions for the agent only.

Does Design Discovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Design Discovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Design Discovery use?

Design Discovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Design Discovery use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Design Discovery?

Skills that share tags, products or a category with Design Discovery: Coding Style (aws-samples/sample-multi-agent-orchestration-chat-on-agentcore, 130 stars), Architect (dralgorhythm/claude-agentic-framework, 125 stars), Idea Superpowers Suite (AkoliteZA/hermes-agent-idea-workflow, 272 stars) and Typeui Fundamentals (bergside/typeui, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Design Discovery?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/designpowers, which has 251 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on June 23, 2026.

Source: Owl-Listener/designpowers on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.