impeccable

Files (154)

• LICENSE
• SKILL.md
• impeccable_asset_producer.toml · agents/
• impeccable_documenter.toml · agents/
• impeccable_finish_reviewer.toml · agents/
• impeccable_manual_edit_applier.toml · agents/
• openai.yaml · agents/
• adapt.md · reference/
• adapt.native.md · reference/
• android.md · reference/
• animate.md · reference/
• audit.md · reference/
• audit.native.md · reference/
• bolder.md · reference/
• clarify.md · reference/
• colorize.md · reference/
• craft-floor.md · reference/
• craft.md · reference/
• critique.md · reference/
• asset-producer.md · reference/degraded/
• documenter.md · reference/degraded/
• finish-reviewer.md · reference/degraded/
• manual-edit-applier.md · reference/degraded/
• delight.md · reference/
• distill.md · reference/
• doctor.md · reference/
• document.md · reference/
• extract.md · reference/
• harden.md · reference/
• hooks.md · reference/
• init.md · reference/
• ios.md · reference/
• layout.md · reference/
• live-setup.md · reference/
• live.md · reference/
• new-work.md · reference/
• onboard.md · reference/
• operate.md · reference/
• optimize.md · reference/
• overdrive.md · reference/
• polish.md · reference/
• quieter.md · reference/
• routing.md · reference/
• shape.md · reference/
• typeset.md · reference/
• visualize.md · reference/
• command-metadata.json · scripts/
• concept-seed.mjs · scripts/
• context-signals.mjs · scripts/
• context.mjs · scripts/
• critique-storage.mjs · scripts/
• detect-csp.mjs · scripts/
• detect.mjs · scripts/
• index.mjs · scripts/detector/browser/injected/
• main.mjs · scripts/detector/cli/
• design-system.mjs · scripts/detector/
• detect-antipatterns-browser.js · scripts/detector/
• detect-antipatterns.mjs · scripts/detector/
• detect-url.mjs · scripts/detector/engines/browser/
• detect-text.mjs · scripts/detector/engines/regex/
• …and 94 more

SKILL.md (first lines)

Produce a complete interface that serves its users and honors the requested visual direction. Preserve product truth and the scope of the change.

Core principles:
- Go all out. No hedging, no shortcuts. The deliverable must be complete (except assets the user must provide).
- Dream big and bold. Distinct, beautiful, outstanding and highly inspiring work.
- Batch inspections and corrections. Match evidence to the changed behavior and supplied references. Continue fixing known acceptance failures within the authorized scope; stop optional aesthetic exploration when the result meets the brief or further passes add no value. A fixed pass count does not make an incomplete result done.

## Setup

1. Resolve `<skill-base-dir>` as the directory containing this `SKILL.md`, using a base directory supplied by the runtime when available. Keep cwd at the user's project and run `node <skill-base-dir>/scripts/context.mjs` once per session. Pass a named source file or route as `--target <path>`. It loads PRODUCT.md, DESIGN.md, the matching surface brief, and native-platform guidance when applicable; follow its directives and do not rerun it.
2. Before acting, load the one playbook that owns the request: the Commands table's reference for an explicit or clearly implied sub-command, or [reference/new-work.md](reference/new-work.md) for a new surface or replacement visual world. Then inspect the target and at least one representative source of incumbent visual truth (tokens, theme, CSS, component, or asset) before editing.
3. After analysis and direction are resolved, load [reference/craft-floor.md](reference/craft-floor.md) immediately before editing UI. It carries the quality floor, the absolute bans, and the reflexes no detector catches. Do not load it for planning-only work.

Reference command paths beginning with `node .agents/skills/impeccable/scripts/` are project-local shorthand. If that path is absent, substitute the resolved `<skill-base-dir>/scripts/` path from Setup; keep the user's project as the working directory.

Reference command examples using `$impeccable`, `/impeccable`, or another
harness prefix mean the current harness's Impeccable skill command. Preserve
the command name and arguments, but use that harness's invocation syntax.

## How to design

- **The brief wins.** Honor pinned aesthetics, eras, materials, fonts, and palettes even when they conflict with a saturated-pattern warning. Redirecting a clear brief toward your taste is failure.
- **Refinement preserves; redesign replaces.** Refinement keeps the incumbent identity, behavior, copy, and everything outside scope. Ask before replacing factual copy or adding claims. Redesign keeps product truth, content, function, native affordances, and constraints, but treats the old look as evidence and anti-reference; choose a replacement world in new-work and replace DESIGN.md. Never split the difference into polish on the discarded look.
- **Visual authority is evidence, not a filename.** Missing DESIGN.md alone does not make a project greenfield; new-work decides whether to preserve, expand, or replace the incumbent world.

## Modes

The mode names what the visitor's success looks like on this surface.

- **Persuade:** the visitor decides and acts; design is the product. Landing pages, marketing, campaigns, pricing. Earn attention and action. Ship real imagery when the brief needs it; follow the committed world, not category habit.
- **Operate:** the visitor completes a task. App UI, dashboards, editors, admin, settings, tools. Scanability, consistency, native expectations, and the real usage scene outrank expression. Brand lives in precise details.
- **Read:** the visitor understands something. Docs, articles, guides, help, changelogs. Structure for comprehension, then make the reading experience worth staying in.
- **Experience:** the visitor is inside the work itself. Portfolios, galleries, showcases. Let the artifact lead from the first viewport; the interface recedes.

Choose the mode from the requested surface, not the product, and persist it only in that surface brief. A tool's landing page is still Persuade; a fashion house's documentation is still Read; a docs index is Read, not Persuade. See [new-work.md](reference/new-work.md) for new surfaces and [operate.md](reference/operate.md) for deeper Operate/Read guidance.

## Commands

| Command | Category | Description | Reference |
|---|---|---|---|
| `craft [feature]` | Build | Deprecated alias for an ordinary new-work request | [reference/craft.md](reference/craft.md) |
| `shape [feature]` | Build | Plan UX/UI before writing code | [reference/shape.md](reference/shape.md) |
| `init` | Build | Capture durable product context in PRODUCT.md | [reference/init.md](reference/init.md) |
| `document` | Build | Generate DESIGN.md from existing project code | [reference/document.md](reference/document.md) |
| `extract [target]` | Build | Pull reusable tokens and components into design system | [reference/extract.md](reference/extract.md) |
| `critique [target]` | Evaluate | UX design review with heuristic scoring | [reference/critique.md](reference/critique.md) |
| `audit [target]` | Evaluate | Technical quality checks (a11y, perf, responsive) | [reference/audit.md](reference/audit.md) · native: [reference/audit.native.md](reference/audit.native.md) |
| `polish [target]` | Refine | Final quality pass before shipping | [reference/polish.md](reference/polish.md) |
| `bolder [target]` | Refine | Amplify safe or bland designs | [reference/bolder.md](reference/bolder.md) |
| `quieter [target]` | Refine | Tone down aggressive or overstimulating designs | [reference/quieter.md](reference/quieter.md) |
| `distill [target]` | Refine | Strip to essence, remove complexity | [reference/distill.md](reference/distill.md) |
| `harden [target]` | Refine | Production-ready: errors, i18n, edge cases | [reference/harden.md](reference/harden.md) |
| `onboard [target]` | Refine | Design first-run flows, empty states, activation | [reference/onboard.md](reference/onboard.md) |
| `animate [target]` | Enhance | Add purposeful animations and motion | [reference/animate.md](reference/animate.md) |
| `colorize [target]` | Enhance | Add strategic color to monochromatic UIs | [reference/colorize.md](reference/colorize.md) |
| `typeset [target]` | Enhance | Improve typography hierarchy and fonts | [reference/typeset.md](reference/typeset.md) |
| `layout [target]` | Enhance | Fix spacing, rhythm, and visual hierarchy | [reference/layout.md](reference/layout.md) |
| `delight [target]` | Enhance | Add personality and memorable touches | [reference/delight.md](reference/delight.md) |
| `overdrive [target]` | Enhance | Push past conventional limits | [reference/overdrive.md](reference/overdrive.md) |
| `clarify [target]` | Fix | Improve UX copy, labels, and error messages | [reference/clarify.md](reference/clarify.md) |
| `adapt [target]` | Fix | Adapt for different devices and screen sizes | [reference/adapt.md](reference/adapt.md) · native: [reference/adapt.native.md](reference/adapt.native.md) |
| `optimize [target]` | Fix | Diagnose and fix UI performance | [reference/optimize.md](reference/optimize.md) |
| `live` | Iterate | Visual variant mode: pick elements in the browser, generate alternatives | [reference/live.md](reference/live.md) |

Routing:

- **No argument:** read [routing.md](reference/routing.md) and present its context-aware menu; never auto-run a command.
- **Explicit or clearly implied command:** load its reference (native variant on native platforms) and follow it. Choose the best fit from the request; ask only when the difference changes a material user decision.
- **Otherwise:** treat the request as general design work. Missing PRODUCT.md routes a new surface or replacement world through init, then new-work; a narrow refinement of existing code proceeds on the incumbent implementation as context.mjs directs, offering init afterward rather than blocking on it.
- `teach` aliases `init`. `craft` is a deprecated alias for ordinary new-work and adds nothing. `shape` owns task discovery, then enters new-work only for visual-world and surface-concept decisions.

After init writes PRODUCT.md, resume without rerunning `context.mjs`; init loads the native platform reference itself when the platform it recorded is `ios`, `android`, or `adaptive`.

**Pin / Unpin:** Run `node <skill-base-dir>/scripts/pin.mjs <pin|unpin> <command>` to create or remove a standalone shortcut for the current harness. Report the script's result concisely; relay stderr verbatim on error.

**Hooks:** Invoke this skill with `hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>` through the current harness's skill command. It manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load [reference/hooks.md](reference/hooks.md) when the user invokes it with any argument.

**Doctor:** Invoke this skill with `doctor` through the current harness's skill command to report and repair drift between this project's Impeccable artifacts (PRODUCT.md, DESIGN.md and its sidecar, config, surface briefs, the hook) and what this version reads. Load [reference/doctor.md](reference/doctor.md) when the user invokes it, or when they ask what is out of date, stale, or needs refreshing. A `CONTEXT_STALE` directive in Setup's output is the cheap subset of the same report; act on it there per its own instructions rather than running doctor unasked.

**Never repair drift as a side effect of a design task.** A `CONTEXT_STALE` finding is reported, not acted on, unless the user asks. The one exception is a finding marked `auto`, which the next write to that file performs anyway.

From maxatwork/skills, MIT.

More from maxatwork/skills