Coding Style
aws-samples/sample-multi-agent-orchestration-chat-on-agentcore
Design decisions, implicit rules, and anti-patterns for the Moca project.
You MUST use this before any creative or design work — building features, creating components, designing interfaces, modifying user-facing behaviour.
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Owl-Listener/designpowers design-discovery --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .claude/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discoveryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Owl-Listener/designpowers design-discovery --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/design-discovery .agents/skills/design-discovery && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .agents/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Owl-Listener/designpowers design-discovery --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/design-discovery .cursor/skills/design-discovery && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .cursor/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Owl-Listener/designpowers.git --path skills/design-discovery--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Owl-Listener/designpowers design-discovery --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/design-discovery .gemini/skills/design-discovery && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .gemini/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Owl-Listener/designpowers design-discoveryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/design-discovery .github/skills/design-discovery && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .github/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Owl-Listener/designpowers --skill design-discovery -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Owl-Listener/designpowers design-discovery --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Owl-Listener/designpowers.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/design-discovery .opencode/skills/design-discovery && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "design-discovery" agent skill from https://github.com/Owl-Listener/designpowers/tree/main/skills/design-discovery into .opencode/skills/design-discovery/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "design-discovery", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
design-discoveryYou 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. 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.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit cb00757. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from Owl-Listener/designpowers at commit cb00757, republished under its MIT licence (© Owl-Listener). 1,117 words, ~2,068 tokens.
.claude/skills/design-discovery/SKILL.md (or your agent's skills folder).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.
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.
DO NOT proceed to any design, UI, or implementation work until discovery is complete and the user has approved the design brief.
When the user says "proof of concept", "POC", "quick", "small", or the task is clearly exploratory:
"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."
design-state.md in the project root immediately after brief approvalQuick discovery should take one user message of answers, not three. But the question should still feel like a person asking, not a form.
When the task is a full product, involves multiple stakeholders, or the user explicitly wants depth — use the full process below.
Before asking questions, gather what already exists:
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:
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:
Weave in taste seeds naturally. Don't make these a separate section — fold them into the conversation when the moment feels right:
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?"
For every design task, explicitly consider:
This is not a checklist to rush through. These are real people who will use what you build.
Present 2-3 design approaches with clear trade-offs:
For each approach:
Once the user has chosen a direction, write a design brief:
# 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
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.
This step is mandatory. Do not skip it.
Immediately after brief approval, create design-state.md in the project root with:
This file is the shared context every agent reads. If it does not exist, the pipeline cannot run.
After approval and design state creation, invoke the appropriate next skill:
research-planningdesign-strategy or writing-design-plansusing-designpowers (auto-triggered on any design task)research-planning, design-strategy, or writing-design-plansui-composition, interaction-design, or any implementation skill| Flag | Response |
|---|---|
| "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
Just SKILL.md in skills/design-discovery of Owl-Listener/designpowers.
Open the folder on GitHubat commit cb00757
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Design Discovery this skillOwl-Listener/designpowers | 251 | — | ~2.1k | Automated safety check: Pass | MIT | |
| Coding Styleaws-samples/sample-multi-agent-orchestration-chat-on-agentcore | 130 | — | ~1.2k | Automated safety check: Pass | MIT-0 | |
| Architectdralgorhythm/claude-agentic-framework | 125 | — | ~475 | Automated safety check: Pass | None | |
| Idea Superpowers SuiteAkoliteZA/hermes-agent-idea-workflow | 272 | — | ~3.9k | Automated safety check: Pass | MIT | |
| Typeui Fundamentalsbergside/typeui | 2k | — | ~861 | Automated safety check: Pass | MIT | |
| Design TrackerDeL-TaiseiOzaki/claude-code-orchestra | 199 | — | ~2k | Automated safety check: Pass | MIT |
aws-samples/sample-multi-agent-orchestration-chat-on-agentcore
Design decisions, implicit rules, and anti-patterns for the Moca project.
dralgorhythm/claude-agentic-framework
Design systems and record architecture decisions as ADRs — a user-invoked Principal Architect workflow.
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.
bergside/typeui
Universal UI/UX design principles covering visual hierarchy, interaction laws, typography foundations, and WCAG accessibility requirements.
DeL-TaiseiOzaki/claude-code-orchestra
Record a project design decision into .claude/docs/DESIGN.md through the shared typed writer.
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…
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…
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…
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.
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…
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…
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.
Categories
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.
Design Discovery fits situations like: tasks that involve Architecture decision records.
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.
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.
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.
SKILL.md names no scripts, command-line tools or credentials: Design Discovery is instructions for the agent only.
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.
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.
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.
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.
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.
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.