Skip to content

IndelibleVivi/servotab / plugins/servotab/skills/design

design

Verified

Turn a rough feature, product interaction, or architecture idea into a concrete design. Use when meaningful decisions remain open; avoid for already-clear local edits.

FileKindSize
SKILL.mdskill md10.4 KB
agents/openai.yamlconfig384 B
assets/icon-400.pngbinary1.4 KB
assets/icon.svgother1.1 KB
---
name: design
description: "Turn a rough feature, product interaction, or architecture idea into a concrete design. Use when meaningful decisions remain open; avoid for already-clear local edits."
---

# Design

Develop the idea far enough that implementation can proceed confidently. Preserve exploration and design pressure without turning every request into a ceremony.

## Start with context

Inspect the smallest useful set of materials:

- Applicable `AGENTS.md`
- The current implementation path
- Nearby tests, schemas, or product documents
- Existing patterns that constrain the decision

Do not scan the whole repository unless the decision is truly cross-cutting.

## Classify reference material

A product description, tutorial, screenshot, example implementation, log, or design document may be:

- **Inspiration:** inform judgment within the user's requested scope; suggested mechanisms remain proposals unless adopted.
- **Evidence:** use it to test a claim about current or desired behavior.
- **Normative:** treat it as binding only when the user or repository makes it part of the accepted contract.

Route by the requested outcome, not the artifact format. A screenshot does not automatically require design exploration, and a long tutorial does not automatically become the project specification. Explicit written instructions and corrections override inferred visual or tutorial details. Ask about the source's role only when the distinction materially changes the result and cannot be inferred safely.

These roles determine authority, not how much relevant content deserves consideration. One source can contain evidence, proposals, and settled choices; classify the content without treating its whole container as either binding or disposable.

When the commission includes deciding what specified discussions, feedback, or references should contribute to existing work, use the Incorporate method for coverage, corrections, and adoption judgment. From the router read `references/incorporate.md`; from the explicit design leaf read `../incorporate/SKILL.md`. Reading may be delegated before selecting an implementation focus. Retain the established source interpretation and project constraints here while resolving the remaining design decisions; do not restart intake.

## Reconstruct the problem

State, in compact form:

- Desired user or system outcome
- Current behavior
- Hard constraints and non-goals
- Proposed mechanism and the assumptions behind it
- Decisions already made by the user
- Material unknowns

Treat the user's existing direction as real input. Do not reopen settled choices simply to manufacture alternatives.

A proposed mechanism is not automatically a settled decision. Unless the user explicitly makes it a requirement, preserve the outcome and constraints while independently evaluating whether that mechanism is the best supported route. Preserve explicitly selected forms, media, interactions, and architecture as constraints; do not abstract them away into a generic need. Do not agree into avoidable complexity, and do not replace the proposal merely because another design is more familiar.

When the user asks to build, adapt, or borrow a named behavior, preserve that direction and explore only the decisions still needed to implement it. Do not turn an implementation request into an open-ended product workshop.

## Let references inform open choices

After enough local context to understand the commission, seek relevant external possibilities before settling a substantial open product, interaction, visual, architecture, or implementation choice. Reuse still-applicable references; a clear goal does not settle the means. Preserve accepted choices even in an empty repo, and distinguish implemented from accepted when revisiting a mature or repeatedly rejected work.

Use the available inquiry method at the point of need. When Soundings is available, its Search method owns discovery and purpose-matched reading; Study, Explore, or Shape can contribute without a mandatory sequence. Compare multiple sources around the same live question, inspect the medium needed for the intended claim, and carry a locally justified relationship into the design. Retain the existing solution when comparison supports it. Findings do not expand authority, and a completed report does not finish an authorized implementation.

## Check the capability boundary

Before designing a new integration, transport, fallback, or abstraction, verify the assumption that makes it necessary:

- What exact current capability or policy blocks the outcome?
- Is that limitation directly observed, or inherited from one mode, old version, or earlier attempt?
- Does the repository, installed runtime, local help, or authoritative platform documentation already expose a direct supported route?
- How many owners, transports, profiles, persistent states, and trust boundaries does each viable route add?

Use readily available world knowledge to generate alternatives, then verify drift-prone technical facts when the result could change the architecture. Prefer the supported route that removes a boundary while preserving the complete outcome. When a small smoke test can settle the decision cheaply, run it before building the bridge.

## Explore the decision surface

Identify the few decisions that change implementation or product behavior. Common examples:

- State ownership
- Persistence and migration
- API or component boundaries
- Error and empty states
- Compatibility
- Rollout and reversibility
- Security or privacy boundaries

For each real decision:

1. Explain the tension.
2. Offer one recommended direction.
3. Include at most two alternatives when they are genuinely viable.
4. State the trade-off in concrete terms.

Do not provide three cosmetic variants merely to satisfy a format.

Ground the recommendation in the condition that actually makes it win over the nearest viable alternative, not in a general virtue of the approach. If the choice rests on an uncertain assumption or priority, name it and what change would reverse the decision. Do not invent alternatives, scores, or causal benefits to justify the pick, and do not treat a lighter option as sufficient unless it still meets the complete behavior.

## Work the decision frontier

Use dependency ordering when decisions remain unsettled. Track only material decisions for the current outcome, their prerequisites, and facts that could invalidate them. Keep settled owner choices separate from provisional mechanisms and reversible choices delegated to the agent.

First investigate facts available from the repository, installed runtime, tools, and relevant authoritative documentation. Present only decisions whose prerequisites are settled, with a recommendation grounded in that evidence. Ask dependent questions after the upstream choice is resolved; continue independent work while another branch lacks evidence. Delegation is optional and requires its own value justification.

After each answer or material new fact, revisit only the affected descendants. In a continuing task, update the existing decision or plan record rather than reopening the whole interview. Stop when the current approach and acceptance criteria can be chosen without silently guessing a material owner decision. Unrelated future branches may remain deferred.

For authorized best-effort work, make reversible assumptions and proceed. An explicit request for design only remains design only; discovering a good solution does not grant implementation authority.

When a technical requirement appears to demand the same property in conflicting states, test whether it must actually hold at the same time, location, condition, or scale. Prefer separating these with existing capability before inventing a mechanism; count any new complexity the separation adds. Adopt a cheap measurement or known supported route directly when it settles the conflict. Stop once a useful candidate or a real residual trade-off appears; not every value disagreement has to be dissolved, and this check is not a required step for every task.

## Questions

Ask a question only when the answer:

- Changes externally visible behavior,
- Controls an irreversible or destructive choice,
- Selects between materially different architectures, or
- Cannot be inferred safely from the repository and prior discussion.

When useful, ask one focused question at a time during an interactive design conversation. When the user asked for a best-effort design or implementation, make explicit assumptions and continue.

## Produce a usable design

Scale the output.

For a local feature, a compact design may include:

- Behavior
- State/data flow
- Main implementation touchpoints
- Edge cases
- Verification

For a cross-cutting change, include:

- Goals and non-goals
- Proposed architecture
- Interfaces and ownership
- Data lifecycle or migration
- Failure handling
- Compatibility and rollout
- Testing strategy
- Open decisions

Use diagrams only when relationships are hard to express in prose.

## Stress-test the recommendation

Before finishing, check:

- What existing behavior could regress?
- What happens with stale, partial, duplicate, or missing data?
- What is the simplest path that still supports the real use case?
- Did the chosen mechanism survive comparison with the platform's direct supported paths?
- Is the design creating infrastructure for an imagined future?
- Can the decision be reversed later?
- What evidence will show the implementation works?

Revise once. Do not create an endless self-review loop.

## Design documents

Write a persistent design document only when one of these applies:

- The user requests it.
- Multiple sessions or people will rely on it.
- The change alters architecture, public contracts, or stored data.
- The decision record will remain useful after implementation.

Otherwise keep the design inline.

## Exit behavior

- If the user asked only for design exploration, stop with the recommendation and open decisions.
- If the user asked to implement, continue to a concise plan or direct implementation according to task size.
- Do not require a separate approval checkpoint when the recommended direction is already supported by the user's request and repository evidence.

## Avoid

- A mandatory interview before touching the problem
- Repeating the user's prompt as a long specification
- Reopening settled choices
- Designing every hypothetical future extension
- Treating a small UI adjustment as architecture
- Writing a design document solely to prove design work occurred
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall