Agent skill

Impeccable

by bestofjs in bestofjs/bestofjs

A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

MITAuto-check passedFrontend & Design

Install Impeccable

skills CLI
$ npx skills add bestofjs/bestofjs --skill impeccable -a claude-code

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

GitHub CLI
$ gh skill install bestofjs/bestofjs impeccable --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/bestofjs/bestofjs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/impeccable .claude/skills/impeccable && 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
impeccable
GitHub stars
3.1k
Used in
27 other repos
Token cost
~2.6k tokens
SKILL.md length
1,132 words
Files
171 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

  • Works in 3 steps: Run node… → Before acting, load the one playbook… → After analysis and direction are…
  • The user wants to design
  • SKILL.md covers Setup, How to design, Modes and Commands
  • Calls node

What it does

Impeccable is an agent skill from bestofjs/bestofjs. Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 172 other files, including scripts (for example `agents/openai.yaml`, `reference/adapt.md` and `reference/adapt.native.md`).

It sits in Frontend & Design, covering UX design, Typography and Design systems. The repository describes itself as: :star: A place to find the best components to build amazing web applications. The best of JavaScript! The licence is MIT.

When your agent uses it

  • The user wants to design
  • Otherwise improve a frontend interface
  • Bland designs that need to become bolder
  • More delightful

Example prompts

  • “/impeccable”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Run node .agents/skills/impeccable/scripts/context.mjs once per session (if the runtime shows this skill's loaded base directory, run node…
  2. Before acting, load the one playbook that owns the request: the Commands table's reference for an explicit or clearly implied sub-command…
  3. After analysis and direction are resolved, load reference/craft-floor.md immediately before editing UI. It carries the quality floor, the…

What it can do on your machine

Read from SKILL.md and the folder at commit 5d82633. 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

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • node

    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

Impeccable loads about 2.6k tokens when it runs. Until then it costs about 227 tokens; SKILL.md has 1,132 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from bestofjs/bestofjs at commit 5d82633, republished under its MIT licence (© bestofjs). 1,132 words, ~2,600 tokens.

Download SKILL.mdSave it as .claude/skills/impeccable/SKILL.md (or your agent's skills folder). This skill also uses 170 other files; get the full folder from GitHub.
name
impeccable
description
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, and reusable design systems or tokens. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks.
version
4.0.4

This skill gives you the tools and permission to create design that earns to be called out-of-distribution craft: Whereas before, your design work would have been safe, timid and measured, you now approach every design task as a award-winning design director with impeccable understanding for what makes exceptional design work: production-grade code, peak creativity, a clear POV, deep understanding of the needs of the client and users, and exceptional craft.

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.
  • Verify in bounded passes, not a loop, and the ceiling covers the whole cycle: screenshots, defect scans, micro-edits, and rebuilds alike. Build fully, inspect once with a batched round (desktop and mobile together), fix everything it shows in one batch, confirm with at most one more round, and stop polishing. Open-ended self-QA burns the user's money doing worse what the finish handoffs do better.

Setup

  1. Run node .agents/skills/impeccable/scripts/context.mjs once per session (if the runtime shows this skill's loaded base directory, run node <skill-base-dir>/scripts/context.mjs; keep cwd at the user's project). 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 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 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.

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 for new surfaces and operate.md for deeper Operate/Read guidance.

Show full SKILL.md (534 more words)Show less

Commands

CommandCategoryDescriptionReference
craft [feature]BuildDeprecated alias for an ordinary new-work requestreference/craft.md
shape [feature]BuildPlan UX/UI before writing codereference/shape.md
initBuildCapture durable product context in PRODUCT.mdreference/init.md
documentBuildGenerate DESIGN.md from existing project codereference/document.md
extract [target]BuildPull reusable tokens and components into design systemreference/extract.md
critique [target]EvaluateUX design review with heuristic scoringreference/critique.md
audit [target]EvaluateTechnical quality checks (a11y, perf, responsive)reference/audit.md · native: reference/audit.native.md
polish [target]RefineFinal quality pass before shippingreference/polish.md
bolder [target]RefineAmplify safe or bland designsreference/bolder.md
quieter [target]RefineTone down aggressive or overstimulating designsreference/quieter.md
distill [target]RefineStrip to essence, remove complexityreference/distill.md
harden [target]RefineProduction-ready: errors, i18n, edge casesreference/harden.md
onboard [target]RefineDesign first-run flows, empty states, activationreference/onboard.md
animate [target]EnhanceAdd purposeful animations and motionreference/animate.md
colorize [target]EnhanceAdd strategic color to monochromatic UIsreference/colorize.md
typeset [target]EnhanceImprove typography hierarchy and fontsreference/typeset.md
layout [target]EnhanceFix spacing, rhythm, and visual hierarchyreference/layout.md
delight [target]EnhanceAdd personality and memorable touchesreference/delight.md
overdrive [target]EnhancePush past conventional limitsreference/overdrive.md
clarify [target]FixImprove UX copy, labels, and error messagesreference/clarify.md
adapt [target]FixAdapt for different devices and screen sizesreference/adapt.md · native: reference/adapt.native.md
optimize [target]FixDiagnose and fix UI performancereference/optimize.md
liveIterateVisual variant mode: pick elements in the browser, generate alternativesreference/live.md

Routing:

  • No argument: read 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. Ask once if two commands fit.
  • 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: node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <command> creates or removes a standalone $<command> shortcut. Report the script's result concisely; relay stderr verbatim on error.

Hooks: $impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> manages the design detector hook for this project (auto-runs the detector after UI file edits and surfaces findings). Load reference/hooks.md when the user invokes it with any argument.

Doctor: $impeccable doctor reports and repairs 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 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.

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

Files

SKILL.md and 170 other files (scripts) in .agents/skills/impeccable of bestofjs/bestofjs.

  • SKILL.md
  • agents/impeccable_asset_producer.toml
  • agents/impeccable_documenter.toml
  • agents/impeccable_finish_reviewer.toml
  • agents/impeccable_manual_edit_applier.toml
  • agents/openai.yaml
  • reference/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/degraded
  • … and 152 more

Open the folder on GitHubat commit 5d82633

Used in 27 other repositories

We found 38 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 27 other GitHub owners. This page covers the copy in bestofjs/bestofjs, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Impeccable 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.

Impeccable compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Impeccable this skillbestofjs/bestofjs3.1k27 repos~2.6kAutomated safety check: PassMIT
Bryl Minimal Designbryllim/bryl-minimal-design114—~2.9kAutomated safety check: PassMIT
UI UX Pro Max SkillJason904/ui-skill-lab144—~865Automated safety check: PassMIT
Design SystemWrongStack/WrongStack368—~3.9kAutomated safety check: PassMIT
UI Crafteduclopez/ui-craft370—~9.5kAutomated safety check: PassMIT
Refactoring UIwondelai/skills2.4k—~3.9kAutomated safety check: PassMIT

Similar skills

  • Bryl Minimal Design

    bryllim/bryl-minimal-design

    Apply the bryl-minimal design language — a monochrome, typography-driven minimal aesthetic with halftone dot textures, pixel-font display headings, tiny uppercase monospace labels, soft large-radius…

    114 GitHub stars~2.9k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • UI UX Pro Max Skill

    Jason904/ui-skill-lab

    A skill your agent uses for UI/UX design intelligence in Codex: planning, building, reviewing, improving, or implementing web/mobile interfaces, landing pages, dashboards, design systems…

    144 GitHub stars~865 tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Design System

    WrongStack/WrongStack

    Use this skill BEFORE writing or restyling ANY user-facing interface.

    368 GitHub stars~3.9k tokensUpdated today
    Frontend & DesignAuto-check passed
  • UI Craft

    educlopez/ui-craft

    A skill your agent uses for UI design and implementation work to avoid generic AI-looking interfaces.

    370 GitHub stars~9.5k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Refactoring UI

    wondelai/skills

    Audit and fix visual hierarchy, spacing, color, and depth in web UIs.

    2.4k GitHub stars~3.9k tokensUpdated 26 days ago
    Frontend & DesignAuto-check passed
  • Cometchat iOS Customization

    cometchat/cometchat-skills

    Brand and restyle the CometChat iOS UI Kit — theme colours, typography, per-component styles, localisation and sounds.

    129 GitHub stars~1.1k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from bestofjs/bestofjs

All 14 skills in this repo
  • Grilling

    bestofjs/bestofjs

    Grill the user relentlessly about a plan, decision, or idea.

    3.1k GitHub starsUsed in 30 repos~464 tokens
    Auto-check passed
  • Setup Matt Pocock Skills

    bestofjs/bestofjs

    Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.

    3.1k GitHub starsUsed in 20 repos~1.7k tokens
    Auto-check passed
  • Wayfinder

    bestofjs/bestofjs

    Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

    3.1k GitHub starsUsed in 20 repos~2.9k tokens
    Auto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 17 repos~2.7k tokens
    Auto-check passed
  • Wizard

    bestofjs/bestofjs

    Generate an interactive bash wizard that walks a human through steps only they can perform.

    3.1k GitHub starsUsed in 11 repos~1k tokens
    Auto-check: notes
  • To Spec

    bestofjs/bestofjs

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    3.1k GitHub starsUsed in 22 repos~757 tokens
    Auto-check passed

Questions about Impeccable

What does Impeccable do?

A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…. Impeccable is an agent skill from bestofjs/bestofjs. Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface.

When should I use Impeccable?

Impeccable fits situations like: the user wants to design; otherwise improve a frontend interface; bland designs that need to become bolder; more delightful.

How do I install Impeccable in Claude Code?

Run `npx skills add bestofjs/bestofjs --skill impeccable -a claude-code`. Or copy the skill folder (.agents/skills/impeccable in bestofjs/bestofjs) into .claude/skills/impeccable in your project. Claude Code loads it when a task matches its description.

How do I install Impeccable in Codex?

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

Can I use Impeccable 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 bestofjs/bestofjs --skill impeccable -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/impeccable, .gemini/skills/impeccable, .github/skills/impeccable and .opencode/skills/impeccable in your project.

What does Impeccable need to run?

Going by SKILL.md and its folder, Impeccable needs the command-line tools its instructions call (node).

Does Impeccable 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 Impeccable 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Impeccable use?

Impeccable 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 Impeccable use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Impeccable?

Skills that share tags, products or a category with Impeccable: Bryl Minimal Design (bryllim/bryl-minimal-design, 114 stars), UI UX Pro Max Skill (Jason904/ui-skill-lab, 144 stars), Design System (WrongStack/WrongStack, 368 stars) and UI Craft (educlopez/ui-craft, 370 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Impeccable?

bestofjs (a GitHub organization) maintains it in bestofjs/bestofjs, which has 3,136 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 4, 2026.

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