Agent Skills
AI agent skills for Claude Code and compatible agents
Tested per skill, scanned by Cisco's skill-scanner.
Install
Install via skills.sh:
# All skills
npx skills add coroboros/agent-skills
# Individual skill
npx skills add coroboros/agent-skills --skill <name>
Requirements
bashpython3(3.10+, stdlib only — nopip installneeded)- A filesystem
Some skills wrap external CLIs — each is declared in its SKILL.md.
Skills
Skills are grouped by plugin. Each plugin collects related skills — expand any section below to see usage, flags, and behavior. Companion skills live in their tool's repo and install from it — see Companion Skills.
| Plugin | Skill | Description |
|---|---|---|
| Workflow | forge | Research, weigh approaches, decide — emit one apex-ready plan |
| Workflow | apex | Structured implementation — Analyze, Plan, Execute, eXamine |
| Workflow | ultrapex | Judgment-first APEX for Fable-class models — invariants, parallel subagents, adversarial verification |
| Workflow | oneshot | Single-pass Explore-Code-Test for small, well-scoped tasks |
| Coding | scaffold | Bootstrap Next.js/Astro projects on Cloudflare Workers |
| Coding | code-ultrareview | Eight-axis judgment review at full strength, in-session — fresh eyes before commit |
| Design | award-design | Art director for award-winning sites — forces a visual universe, writes DESIGN.md and the build ladder, audits any site |
| Design | frontend-dev | Everyday frontend lane — commit ritual, surface archetypes, hard floors, fingerprint ban |
| Design | design-system | Govern an existing DESIGN.md — token enforcement plus a CLI lifecycle |
| Claude Code | claude-md | Create and optimize CLAUDE.md and .claude/rules/ |
| Claude Code | agent-creator | Expert guidance for creating Claude Code subagents |
| Media | video-loop | Loop background videos with invisible cut points |
| Media | audio-loop | Gapless web-ready ambient audio loops (FLAC + Web Audio) |
| Media | suno-produce | Turn a music brief into Suno v5.5 prompt artifacts |
| Media | markitdown | Convert PDF/Office/HTML/audio/YouTube to Markdown via Microsoft's CLI |
| Media | download-media | Download video, audio, playlists, clips, subtitles from ~1800 sites via yt-dlp |
| Productivity | notion | Notion via the official MCP connector, or the ntn CLI for uploads and CI |
| Writing | brand-voice | Govern BRAND-VOICE.md — extract, update, validate; feeds humanize-en -f |
| Writing | write-clear-readme | Author, audit, or polish READMEs — clarity, structure, concision |
| Writing | humanize-en | Strip AI tells from English prose — brand-aware via -f BRAND-VOICE.md |
| Companion | scrybe | Offline Whisper speech-to-text — transcripts, subtitles, translation |
| Companion | skillward | Vet an untrusted skill, plugin, or MCP server before install — offline scanner ensemble, one verdict |
| Companion | shellscan | Find and lint every shell in a project — .sh, shebangs, GitLab CI YAML |
| Companion | karate | Write, run, and triage Karate API and integration tests |
Skills inherit the session model — no model: pins, so a stronger session is never downgraded by a skill. Scope is two-tier per the Agent Skills spec: portable skills omit the compatibility field entirely; Claude Code-optimized skills declare it and degrade gracefully on any open-standard agent (see Standards).
Workflow Skills
Strategic thinking, planning, and implementation — forge, apex, ultrapex, oneshot.
forge
Pre-implementation thinking — research the problem space, weigh approaches with devil's-advocate rigor, decide what's reversible while surfacing the load-bearing forks for the user, and emit one apex-ready plan. The "think" half; apex is the "build" half.
Usage
# Exploratory question — default emits a Decision and pauses for decompose
/forge should we use Neon or Supabase for our serverless Postgres?
# Build verb in the idea — promotes to a Spec with workstreams
/forge -s add user authentication with OAuth and email/password
# Auto mode + create GitHub issues
/forge -s -a -i migrate from REST to GraphQL
Flags
| Flag | Description |
|---|---|
-s / -S |
Save artifact to ~/.agents/output/{project}/forge/forge-{slug}.md / force no-save |
-i / -I |
Create GitHub issues from workstreams (implies -s) / disable |
-a / -A |
Auto mode — skip Q&A, decide reasonable forks, no revision pause / disable |
-e / -E |
Economy mode — no subagents (Hunt research floor and Judge's adversarial panel) / disable |
-f |
Load prior context (forge plan, RFC, GitHub issue #N or URL) |
Uppercase forms disable the ambient default when the skill runs with a pre-set mode. Requires gh authenticated when using -i or passing a GitHub URL/#N to -f.
What it does
- Hunt — frames and reframes the real problem, then researches wide via parallel subagents above a hard floor: ≥1 codebase + ≥1 external agent every run,
-ethe only escape. Triangulates sources rather than picking one, and auto-launches a second research round when the premortem surfaces an unresearched failure mode. On-demand references for breadth (research-discipline.md), the 5-question clarify playbook (clarify-playbook.md), and subagent prompt skeletons (subagent-prompts.md). - Judge — diverges ≥3 structurally distinct approaches, stress-tests with premortem + steelman, then runs an adversarial panel (3-5 lensed clean-context critics in parallel) and a bounded convergence round on the survivors — the same conversation cannot reliably argue against the plan it just shipped (
adversarial-panel.md). - Decide — three tiers: decide the reversible and conventional calls, surface the structurally load-bearing forks for the user (named with the pick, the runner-up, and what would flip it), escalate the few forks the user genuinely owns.
- Forge — chooses the artifact shape, walks a pre-save audit, saves, validates (when there are workstreams), pauses for revision under non-auto, then routes.
Routing. Default = # Decision: (terminal — present and ask the user whether to decompose into workstreams, then wait). Promotes to # Spec: (with 3-7 workstreams + /apex bridge) when -a is set, when -i forces issue creation, when -f points at a prior Spec, when the idea carries an unambiguous build verb (build, add, implement, migrate, refactor, create, …), when it carries an explicit decomposition signal (plan, break down, spec out, workstreams, issues, roadmap), or when the Decision IS the build plan.
Sources
- anthropics/knowledge-work-plugins — product-brainstorming — divergent/convergent ideation modes and frameworks
- anthropics/knowledge-work-plugins — write-spec — PRD structure, acceptance-criteria craft, ruthless prioritization
- Melvynx/aiblueprint — ultrathink — craftsman simplification discipline
- mattpocock/skills — grill-me — decision-tree interview behind the opt-in deep grill
- mattpocock/skills — to-issues — vertical-slice decomposition and HITL/AFK tagging
apex
Systematic implementation using the APEX methodology — Analyze, Plan, Execute, eXamine — with parallel subagents and self-validation.
Usage
# Autonomous + save outputs
/apex -a -s implement user registration
# From a GitHub issue
/apex -f "#42" implement what issue 42 describes
# From a prior forge plan
/apex -f ~/.agents/output/{project}/forge/forge-{slug}.md implement WS-1
# Resume a previous task
/apex -r 01-auth-middleware
Flags
| Flag | Description |
|---|---|
-a / -A |
Autonomous mode — skip confirmations / disable |
-s / -S |
Save outputs to ~/.agents/output/{project}/apex/{task-id}/ / force no-save |
-e / -E |
Economy mode — no subagents / disable |
-b / -B |
Branch mode — verify not on main, create branch if needed / disable |
-g / -G |
Wire /goal to loop step-04 until AC verified (auto-on under claude -p; requires Claude Code v2.1.139+) / disable |
-f |
Load prior context (GitHub issue #N, forge plan, RFC) |
-r |
Resume a previous task by ID |
-i |
Interactive flag configuration |
Uppercase forms disable the ambient default when the skill runs with a pre-set mode.
What it does
- Analyze — launches 1–10 parallel subagents based on task complexity. Infers acceptance criteria in Given/When/Then form with explicit
## Not Includednegative scope. When-fpoints to a spec (H1# Spec:+## Workstreams), accepts the spec's AC verbatim (closure rule) instead of re-inferring. - Plan — file-by-file implementation strategy with AC mapping. Inline Challenge mini-phase (premortem + alternative consideration) stress-tests the plan. Surgical-scope advisory fires when the plan touches >5 files, >2 systems, or introduces cross-cutting concerns — advisory only, never blocks.
- Execute — todo-driven implementation with progressive step loading.
- eXamine — derivation lens (code↔plan reconciliation, classifying each divergence as GAP / SCOPE-ADD / DECISION-OVERRIDE / CONSISTENT) runs before typecheck/lint/tests. GAP blocks completion; SCOPE-ADD advisory unless declared in negative scope; DECISION-OVERRIDE surfaces for user judgment. Optional
/goalintegration via-gloops the session until AC verified — transcript-only Haiku evaluator, requires Claude Code v2.1.139+; auto-on underclaude -p. - Resume —
-rauto-validates state viavalidate_state.shbefore restoration; partial or corrupt task dirs fail loud rather than cascade.
Accepts output from forge via -f. Works standalone.
Trust model
Analyze fetches third-party content into the workflow — web research via general-purpose subagents, library docs via Context7, GitHub issue bodies via -f #N, any file passed to -f. An adversarial document hosted at a fetched URL, or pasted into an issue body, can attempt indirect prompt injection. User review of the analysis report before approving the plan is the trust boundary — confirm the surfaced files, patterns, and acceptance criteria match intent. Pass -e (economy mode) to disable subagents and remove the third-party surface entirely. Full disclosure in skills/apex/SKILL.md § Trust model.
Sources
- Melvynx/aiblueprint — apex — APEX methodology (Analyze, Plan, Execute, eXamine) reference implementation
ultrapex
Outcome-driven end-to-end implementation for Fable-class frontier models — the judgment-first sibling of /apex: same mission, invariants instead of step scripts.
Usage
# Implement end to end, save the report
/ultrapex -s implement user registration
# Build a forge plan
/ultrapex -f ~/.agents/output/{project}/forge/forge-{slug}.md
Flags
| Flag | Description |
|---|---|
-s |
Save the final report to ~/.agents/output/{project}/ultrapex/ |
-f |
Feed a producer artifact (usually a forge plan) as the task context |
What it does
Five invariants instead of gated steps: understand before building, decide and commit (pause only at genuine forks), build complete and scoped, verify adversarially with fresh-context refuter subagents scaled to blast radius, report grounded in tool-result evidence. Self-scoped by a Model scope section — on models below Fable-class it routes to /apex, which keeps step gates, resume, and economy mode.
oneshot
Single-pass feature implementation — Explore, Code, Test. Ship now, iterate later.
Usage
/oneshot add dark mode toggle to the navbar
/oneshot #42
What it does
- Resolve — if input is a GitHub issue (
#Nor URL), fetches viaghand uses the title/body - Explore — finds 2–3 key files, searches for patterns (no tours)
- Complexity check — if >5 files or multiple systems, suggests
/apexor/forgeinstead - Code — follows existing codebase patterns exactly
- Test — runs lint and typecheck, fixes only what it broke
One task only. No tangential improvements, no refactoring outside scope. Stops after 2 failed attempts.
Sources
- Melvynx/aiblueprint — oneshot — Explore/Code/Test loop with complexity escalation to
apexorforge
Coding Skills
Bootstrap projects and review changes before commit — scaffold, code-ultrareview.
scaffold
Scaffold new web projects with an opinionated stack on Cloudflare Workers.
Strict opinion — no Vercel/Netlify, no ESLint/Prettier. Use a different scaffold for any other stack.
Requirements
- stable even-numbered Node.js >= 22.12.0
pnpm— provision a reviewed version via Corepack (corepack enable && corepack install --global pnpm@<reviewed-version>) or the official pnpm installerjq
Usage
/scaffold next-cloudflare my-saas
/scaffold astro-cloudflare landing-page
/scaffold next-cf # alias
Scaffolds
| Scaffold | Framework | Infra | Key stack |
|---|---|---|---|
next-cloudflare |
Next.js 16 (App Router) | Cloudflare Workers (OpenNext) | Drizzle + Neon, Better-Auth, shadcn/ui, Vitest, Playwright |
astro-cloudflare |
Astro 6 (SSG-first) | Cloudflare Workers | Zero JS default, Content Collections, SEO rules |
Shared: TypeScript strict, pnpm, Biome, Tailwind CSS.
What it does
Runs the official framework CLI, preserves the generator's ignore rules while overlaying the opinionated config (Biome, Cloudflare Workers, canonical AGENTS.md, thin CLAUDE.md adapter, shared .agents/rules/, pnpm scripts, .worktreeinclude — copies dev-critical gitignored files into Claude Code worktrees), and installs the full stack. When installed, /award-design (award-level direction), /frontend-dev (everyday UI), and /design-system are optional follow-on handoffs.
code-ultrareview
Eight-axis judgment code review at full strength, in-session. The default runs every axis and the full applicable battery with no sampling; --axes is an explicitly scoped mode with no repository verdict. The 8 axes (Correctness, Simplification, Tests, Documentation, Style, Intent, Design/API, Performance) run as parallel Explore subagents on Claude Code or the harness equivalent; Coherence joins as a 9th when a manifest, SKILL.md, tsconfig.json, pyproject.toml, Cargo.toml, go.mod, or root README.md is in the diff. In-session on the user's own subscription — distinct from Anthropic's remote /ultrareview.
Usage
/code-ultrareview # full 8-axis review, print report
/code-ultrareview -s # save the report + JSONL for /apex -f
/code-ultrareview -b origin/main # review HEAD against an explicit base
/code-ultrareview --verify-build # require the canonical project test gate to pass
/code-ultrareview --mutation-test # add Stryker / Pitest / mutmut on changed files
/code-ultrareview --reconcile @auto # add Intent-axis derivation sub-mode
/code-ultrareview --apply-safe # full review + gated low-risk fixes
/code-ultrareview --preflight # list tools the battery would run, no review
/code-ultrareview --axes correctness,tests # subset of axes
Flags
| Flag | Description |
|---|---|
-s / -S |
Save the report + JSONL to ~/.agents/output/{project}/code-ultrareview/code-ultrareview-{slug}.{md,jsonl} / force no-save |
-b <ref> |
Override the review base (skip auto-detection) |
--repo-kind <kind> |
Override the scope classifier. <kind> ∈ skills, app, library, docs, monorepo, python, rust, go, unknown. Persistent per-repo at .code-ultrareview.yaml; the flag wins on conflict. Invalid value exits 2 |
--reconcile <input> |
Activate the Intent-axis derivation sub-mode. <input> ∈ @auto, @pr, an explicit path or directory, gh:pr:<N>, gh:issue:<owner>/<repo>#<N>, or a GitHub issue URL |
--verify-build |
Run the canonical project test command as an atomic gate. Missing prerequisites, failures, and timeouts block; generic results never re-score findings |
--mutation-test |
Stryker targets changed JS/TS source files; configured Pitest/mutmut runs emit changed-file survivors and uncovered mutations. Maven and Gradle run from PATH in offline mode. Missing config/tool, incomplete evaluation, or a failed run blocks the review |
--apply-safe |
Opt-in writers — manifest version sync, structured-field description sync (full-agreement guard), one failing test per confirmed bug. Diff preview + per-file confirmation |
--include-prose |
Coherence axis compares README freeform paragraphs (default: structured fields only) |
--axes <list> |
Comma-separated axes subset (e.g. correctness,tests). Default: all 8 + Coherence when triggered |
--preflight |
Validate applicable analyzers and print exact install commands. Exits 3 when coverage is incomplete; never installs |
The five phases
- Scope — deterministic, no LLM: resolves the diff, classifies the repo (one of 9 kinds), reads the cross-agent instruction chain, decides whether Coherence activates.
- Tool battery — per-language static analysis (table below); findings carry
confidence: 100and skip validation. Never auto-installs. - Axis review — 8–9 parallel
Exploresubagents, each scoped to its axis with the diff + filtered tool findings, scoring 0–100 against the verbatim Anthropic rubric. - Validation — a fresh-context validator (Haiku on Claude Code) re-scores every sub-80 finding. A2 no-silent-drop: promoted (≥80), demoted with reason, or surfaced in
### ⚠️ Unverified— never omitted.--verify-buildruns before this. - Synthesis — dedup, inter-axis precedence, a
Ship/Fix-then-ship/Needs workverdict, Conventional Comments JSONL, and a mandatoryWhat I did NOT checkclosing section (defers security to/security-review, runtime perf, flaky detection).
Tool battery — tool → axis
The battery resolves every applicable analyzer before running the first one. A JavaScript declaration at the repository root or one workspace covering every input relevant to that tool is authoritative: the battery runs that direct or hoisted binary. In a Yarn Plug'n'Play project, where node_modules/.bin is intentionally absent, it invokes the declared binary through Yarn with network access disabled. Multiple declarations or mixed declared and undeclared package scopes block until the analyzer is declared once at the repository root. Without a declaration, it may use an installed PATH command. It never resolves packages at runtime. Missing or failed analyzers block with exact remediation and rerun commands before any axis reviewer or verdict. Run /code-ultrareview --preflight to validate the current repo.
| Tool | Axis | Source |
|---|---|---|
knip |
Simplification (JS/TS dead code) | declared project (node_modules/PnP), else PATH; needs a covering package.json |
jscpd |
Simplification (structural cross-language clones; default 15 lines / 100 tokens) | declared project (node_modules/PnP), else PATH |
markdownlint-cli2 |
Documentation (project-overridable structural lint; neutral line-length and compact-table base) | declared project (node_modules/PnP), else PATH |
api-extractor |
Design/API (TS public surface) | declared project (node_modules/PnP), else PATH |
lizard |
Simplification (cyclomatic complexity) | PATH |
vulture |
Simplification (dead Python code) | PATH |
semgrep |
Performance (bundled perf-rules only) | PATH |
vale |
Documentation (prose lint) | native |
oasdiff |
Design/API (OpenAPI breaking changes) | native |
atlas |
Design/API (DB migration lint) | native |
deadcode |
Simplification (Go unreachable) | native |
gocyclo |
Simplification (Go complexity) | native |
dupl |
Simplification (Go duplication) | native |
cargo-machete |
Simplification (Rust unused deps) | native |
Bundled Semgrep perf-rules (references/perf-rules/) route N+1 and sync-IO findings to the Performance axis.
Rules
- Zero auto-install — never runs
brew/cargo/go/pip/npm -g; natives are installed explicitly. - Atomic coverage — a missing or failed applicable analyzer stops before axis review; fix the printed prerequisite and rerun. An analyzer that cannot apply to the scope is recorded as not applicable; the review continues.
- Cite precisely — every finding carries
file:line; instruction-rule findings quote the violated rule verbatim and name its source file.
Sources
- anthropics/claude-plugins-official — code-review — verbatim 0/25/50/75/100 rubric, HIGH SIGNAL criteria, false-positive taxonomy, agent-assumption rule, parallel-reviewer + Haiku-validator pattern
- anthropics/claude-plugins-official — code-simplifier — Simplification axis precedent (nested ternaries forbidden, "fewer lines over readability" forbidden)
- Anthropic — Code Review docs — Managed Code Review severity tiers (Important / Nit / Pre-existing) adopted in synthesis
- Anthropic —
/ultrareviewdocs — remote sandbox + multi-agent fleet + per-finding independent verification (the upstream this skill distinguishes itself from — in-session vs remote, distinct namespace) - mattpocock/skills — improve-codebase-architecture — deletion test for shallow-module / wide-interface smells (Ousterhout deep modules) in the Design/API axis
Design Skills
Award-level art direction, the everyday frontend lane, and DESIGN.md token governance — award-design, frontend-dev, design-system.
award-design
An art director targeting Awwwards SOTD 7.5+, FWA, CSSDA. Takes the lead when the brief names the ceiling: award-winning, premium, signature, a new visual identity, an uplift or ground-up redesign. Forces a committed, anti-default visual universe, writes it as a DESIGN.md (the Google open standard) and a design-plan.md whose ladder of build chunks any executor runs one at a time; handed one chunk, builds that chunk alone under its gates. Adapts to an existing DESIGN.md and alerts when it is thin. Frontend only — single-token tweaks route to /design-system, everyday no-award work and dashboards or internal tools at any ambition to /frontend-dev, never backend. A review mode audits any site at any time.
Usage
/award-design landing page for a sustainable coffee brand # direction → DESIGN.md + design-plan.md with the ladder
/award-design chunk hero # build one ladder chunk
/award-design -u https://linear.app portfolio for a motion designer # brand-extract a live site as the seed
/award-design review https://example.com # audit an existing site
A brief ends with the direction (DESIGN.md and design-plan.md with its ladder) and builds nothing; the ladder's chunks build, one per executor run. chunk <id>, or a pasted ladder chunk, builds that chunk alone and writes its Report into the ladder row. -u <url> reverse-engineers the brand from a live site as the archetype seed; the observation informs the direction but doesn't constrain it — the brief is still the destination. review <url|path> runs the adversarial critic against any site at any time, no build required.
Archetypes
Each archetype anchors to a canonical winner (corpus-credentialed). The reference file splits DNA (non-negotiable identity, mood-agnostic) from common expressions (2–4 named stacks per archetype), so one DNA admits multiple valid styles — Immersive runs cinematic-dark, editorial-portrait, or daylight-automotive without losing identity.
| Archetype | Canonical reference | Ideal for |
|---|---|---|
| Minimalist | Terminal Industries (SOTM Sept 2025) | SaaS, luxury, architecture, portfolios |
| Brutalist | Eloy Benoffi (GSAP SOTD + CSSDA) | Creative agencies, indie tech, festivals |
| Editorial | Siena Film Foundation (SOTD 18 Mar 2025) | Media, fashion, cultural institutions |
| Bold / Maximal | Ponpon Mania (SOTM Oct 2025) | Entertainment, music, Gen Z brands |
| Immersive / Cinematic | Lando Norris (SOTD 17 Nov 2025, 8.18) | Automotive, luxury, gaming, athlete portfolios |
| Experimental | Bruno Simon (SOTM Jan 2026) | Developer portfolios, art institutions |
| Corporate Luxury | Cartier WAW 2025 (SOTD 18 Aug 2025) | Fashion, hotels, jewelry, wealth, watchmaking |
| Bento / Card | Anime.js v4 (SOTD 6 May 2025) | SaaS product pages, AI products, feature comparisons |
| Spatial Organic | Igloo Inc (SOTY 2024) | Sustainability, wellness, post-2025 creative studios |
Key features
- Direction by dice — the model writes 5–7 candidate spines, then a seeded roll (
scripts/direction_roll.py, SHA-256, offline, reproducible from its printed key) assigns one with the model's top two structurally unreachable, because a model's own ranking converges on the same direction every run. Challengers dealt from sibling archetypes must beat the assignment on audience identification and product clarity to take the build; the category standard stays on the table as the user's standing exit, never the model's recommendation - The six-block contract — THESIS · OWN-WORLD · STORY (the desire arc's five content answers) · FIRST-VIEWPORT · FORM+SEED · SIGNATURE (verb · medium · trigger · replay), ≤180 words, written before any build file and copied into the first artifact's opening comment. A block that reads like a mood is not decided yet; a fresh-context R1 refutes the concept before code exists
- The ladder — the direction run ends with
design-plan.md, its build written underLADDER:as chunks fromreferences/chunk-template.md(Read first · Implement · Verify · Out of scope · Report), in order: the shell → the hero (2–3 distinct directions through one shared render frame, a fresh-context judge picking beside the archetype's live exemplar) → the sections, paced like a score with one climax and at least one rest → the award surfaces (loader, nav, cursor, footer moment, route transitions, sound; each committed or declared out with a reason) → further pages → the review. One chunk per executor run: this skill in chunk mode,/apex,/ultrapex, or any agent; a chunk that would change DESIGN.md is handed back as a scope change - Two-tier archetype knowledge — nine ~40-line tier-1 files (DNA, anti-signals, reflex lists) pushed into context by the roll itself; nine tier-2 references loaded by heading (effect palettes, page recipes, mid-page life, spectacle menus), every claim carrying its evidence class — winner, shipped, technique, theory — and only the first three bind
- Techniques as skeletons, facts with dates — seven complete wirings (
references/skeletons.md) each closing on the failure it prevents (the Lenis autoRaf double-drive ships fixed);references/stack-facts.mdis the dated authority for every version and support figure, with staleness surfaced by the scanner past 180 days - The mechanical floor — the static scanner (42 rules incl. the OPTICAL-* craft family), two browser payloads injected by the harness (
render-floor.js: text-on-text, clipped glyphs, zero-width content, CTA-in-fold, missing mobile nav, per width 375–1920;pixel-metrics.js: emptiness, ink profile, ground commitment, accent frequency — evidence only), and the computed-style detector, run by every chunk's Verify on the files and pages it touches. One browser session per run; payloads never own a process - The review owns the verdict — the ladder's last chunk, one fresh-context driven audit (
references/gate/review.md): inventory before anchoring, the comparative desire read beside the live exemplar (DESIRE-READ: BEATS|LOSES — cause: concept|execution|craftroutes the remedy), a bounded fix loop, and a ship label the builder cannot write — READY only via the reviewer's synthesis or the human's yes, REVIEWED-SAME-CONTEXT when neither exists - Review mode standalone —
award-design review <url|path>runs the same instrument on any site: archetype derived from the target, scored against the awwwards rubric with the desire read and ordered findings, no ship label - Anti-AI-slop hard constraints — the AI-purple gradient, Inter/Roboto on the display face, pure
#000/#fff, placeholder names and fake stats, meta-labels, eyebrow spam, scroll hijack, sub-device-resolution signature assets — match-and-refuse, machine-checked where a rule is named, overridden only by a quoted client clause - Imagery — real assets, an acquire-and-verify protocol for branded builds, every signature asset ≥ device pixels at its worst rendered moment, never faked out of divs
- WebGL/3D delegation — a committed scene is one ladder chunk handed to one subagent under a tested delegation contract (DESIGN.md quoted verbatim, fidelity and input-correctness floors, poster-first LCP); the returned module is integrated in-context, never co-written
- Judging criteria — Design 40%, Usability 30%, Creativity 20%, Content 10%; HM 6.5+, SOTD ~7.5+, routine SOTD 7.2–7.9. Performance measured with provenance: LCP < 1.5s, CLS < 0.05, INP < 100ms
- DESIGN.md handoff — authors the DESIGN.md up front and every chunk builds under it;
/design-systemgoverns it afterward (drift, updates, audits). Clean author-vs-govern boundary
Sources
- Award-winning websites 2025-2030 (Coroboros Research) — judging criteria, SOTD/SOTY patterns, studio analysis (Locomotive, Active Theory, Resn, Immersive Garden, Cuberto)
- Leonxlnx/taste-skill — the ambient-forcing / art-director reference
- Google DESIGN.md — the open standard for the DESIGN.md this skill writes;
@google/design.mdCLI lints the output - greensock/gsap-skills — motion canon, deferred to by name when installed
- Vercel Web Interface Guidelines — UX quality rules
- dev-browser — CLI visual review
frontend-dev
The everyday frontend lane — pages, dashboards, forms, components, quick landings. Commits a five-line direction (SURFACE · WORLD · TYPE · COLOR · SIGNATURE) before any code, fixes composition by surface archetype, holds hard floors on type, spacing, color, and motion, and refuses the model's fingerprint page by name. Reads a DESIGN.md or an award-design ladder chunk as the brief when one exists. One file, fully resident — no references, no scripts.
Usage
/frontend-dev add a changelog page # everyday work — ritual, floors, fresh-pixels verify
/frontend-dev build the admin dashboard # Monitor surface — dense grid, full states, no hero
/frontend-dev quick landing for the beta # Persuade surface — conversion lines above the ritual
Key features
- The commit ritual — five lines with concrete values, written in the response and copied into the first file's top comment; the first instinct is named and rejected, identity derives from the subject's world, never a template
- Surface archetypes — seven compositions (Persuade, Monitor, Decide, Create, Browse, Read, Enter) decided by what the page is for; hero-plus-cards fits exactly one of them
- Hard floors — snapped type scale, body ≥ 16px, 45–75ch measure, base-4 spacing, one accent doing accent work only, contrast ≥ 4.5:1, the separation ladder (spacing → dividers → tint → borders → shadows), one easing family, a reduced-motion branch always
- The fingerprint ban — ten model defaults matched and refused: the purple gradient, Inter on display, three equal cards, eyebrows, center-stack, nested cards, default glassmorphism, invented stats, em-dash copy, icon toppers
- States and ship — five interactive states, three data states, and a ship checklist (375/768/1440, designed 404, alt text, skip link, keyboard path, zero console errors, one signature moment)
- Conversion pass for landings — OFFER / AUDIENCE / ACTION above the ritual; proof beside claims, an objections section, risk reversal, one CTA repeated
- Brief consumption — DESIGN.md tokens are law when present; an award-design ladder chunk hands to
/award-designchunk mode when installed, else runs under its own Verify; award asks on a landing, portfolio, product or marketing site, single-token changes, and empty directories route to/award-design,/design-system,/scaffold; dashboards and internal tools stay at any ambition
Sources
- The winning recipe of AI design skills (Coroboros Research) — the eleven-system corpus read this lane distils
- elayadesign/ai-design-skills — the resident single-file lane, conversion before visuals, terminal checklists
- elayadesign/redesign-skill — the "make it look better" register
- NousResearch/hermes-agent — surface archetypes; slop as a compositional defect
- pbakaus/impeccable — the first-instinct-is-spent commitment, measured verification
- Nutlope/hallmark — the fingerprint ban lists
- openai/plugins — the separation ladder, state coverage, blocking gates
design-system
Govern an existing DESIGN.md — the Google DESIGN.md open standard (YAML frontmatter tokens + eight prose sections). Activates by intent during UI edits to enforce token-only sourcing when a DESIGN.md is present, and steps aside when none exists — it never blocks the edit or invents a design direction (that is /award-design's job — it forces a universe, writes the DESIGN.md and the build ladder; everyday UI work without a file belongs to /frontend-dev). Exposes seven subcommands, four backed by the canonical CLI, for the full DESIGN.md lifecycle. audit-extensions closes the bidirectional drift loop between DESIGN.md extension namespaces (motion, shadows, aspect-ratios, heights, containers, breakpoints, z-index, border-widths, opacity, scroll-triggers — see references/extended-tokens.md) and the globals.css @theme mirror.
Requirements
designmdonPATH:npm install --global --ignore-scripts @google/design.md, thendesignmd --version. Bundled wrappers never resolve packages at runtime; a missing, failed, or invalid CLI blocks with exact repair and rerun guidance.
Usage
Use during UI edits such as:
src/components/**,src/app/**,src/pages/**,src/layouts/**,src/styles/**src/features/*/components/**DESIGN.md,tailwind.config.*
It is also invocable directly via /design-system with one of seven subcommands:
/design-system audit # lint ./DESIGN.md, report with fix proposals
/design-system audit ./docs/DESIGN.md -s # save the report under ~/.agents/output/
/design-system diff # diff ./DESIGN.md vs HEAD (git-aware)
/design-system diff old.md new.md # two-file diff
/design-system export tailwind # → tailwind.theme.json
/design-system export dtcg -o tokens.json # W3C DTCG format
/design-system spec --rules # emit canonical spec + lint rules
/design-system migrate ./legacy-DESIGN.md # Stitch 9-section → Google standard
/des
No comments yet
Be the first to share your take.