What this resource does
Core uses
One design Skill with task-specific commands
The repository documents one Impeccable Skill and 23 commands. The three tasks below are a selection, not the complete command list. Our example tests polish only.
Three documented commands described; one command tested in one local case.
impeccable polish
Checks the existing design and refines spacing, type, responsive layout and interaction states while preserving its content and behaviour.
- Typical inputs
- An existing interface and its source files; The parts you want refined and any design constraints
- Output
- Changes to the interface code, with a review of the rendered page.
Best for: A working page that needs a focused finishing pass.
Component for this task
impeccable polish
Checks the existing design and refines spacing, type, responsive layout and interaction states while preserving its content and behaviour.
Suggested requests (1)
Polish the spacing and responsive layout of this page while keeping its content and behaviour unchanged.
Adapted into complete requests from official trigger wording in .agents/skills/impeccable/reference/polish.md.
impeccable audit
Checks interface quality, including accessibility, performance and responsive behaviour.
- Typical inputs
- An interface and the files or area to inspect
- Output
- Findings about the inspected interface.
Best for: Finding specific problems before making changes.
Component for this task
impeccable audit
Checks interface quality, including accessibility, performance and responsive behaviour.
impeccable adapt
Adapts an interface for different devices and screen sizes.
- Typical inputs
- An existing interface; The target devices and screen sizes
- Output
- Device-specific interface adjustments.
Best for: A page that needs to work on additional screen sizes.
Component for this task
impeccable adapt
Adapts an interface for different devices and screen sizes.
Use boundaries
Limits and checks
Local code runs during setup
The installer and engine can run on your computer and change project files.
Review the repository and dependency files before installing and running third-party code locally.
A design scan is not a complete usability test
Automated checks do not establish that every workflow is usable or visually appropriate.
Open the changed page and try the main tasks on the devices that matter to you.
Commands have different scopes
Polishing an existing page and redesigning it are different tasks.
Name the task and state what must stay unchanged.
More boundaries
- Backend-only tasks are outside the documented Skill scope.
- The test does not cover automatic hooks, the browser extension or other agents.
Technical details
- Resource type
- Toolkit
- Author or maintainer
- Paul Bakaus
- Version
- Skill 4.2.2; npm package 4.0.4; engine 0.1.3
- Source last updated
- 7 Sept 2026
- Last verified
- 7 Sept 2026
- Licence
- Apache-2.0
- Access
- Publicly available
- Additional costs
- AI application terms or usage limits may apply.
- Skill instruction language
- English
- Documentation language
- English
- Repository languages
- JavaScript, Shell
- Dependencies
- Node.js >=22.18.0 for the npm installer; Platform-specific Impeccable engine; A supported AI coding application
- Review status
- Polish tested
Continue exploring
Related resources
Official package contents
Files
Read the official English instructions without leaving this profile. This view includes the English files represented by this profile. Non-English source files, supporting code, assets, tests, and references may not be shown.
Official package files
5 files available here
.agents/skills/impeccable/reference3
.agents/skills/impeccable1
Read on this page
Select a file
Choose a file from the tree to read its official instructions without leaving this page.
Independent testing
Evaluation report
See exactly what was tested, which checks were used, and what the result does not cover.
Evaluations are mainly based on automated AI-assisted checks. Results are for reference only.
One example
Making a workshop directory easier to browse
We asked Impeccable polish in Codex to tidy a working workshop directory. It gave phone descriptions more room and enlarged the controls while keeping search, filters and all six session details working. The chart still needs to be opened at full size to read its small labels comfortably.
Codex desktop, current authorised session; local macOS and Playwright Chromium · Model not recorded · 7 Sept 2026
What we asked it to do
Refine a working workshop directory without changing its information or removing its search, filters and session details.
Exact request used in the test
Use Impeccable polish on this workshop directory. Keep the green-and-white identity and all workshop information unchanged. Improve the visual hierarchy, spacing and mobile layout. Preserve search, topic filtering, the result count, empty state and session details. Make it comfortable to use on desktop and a 390-pixel-wide phone. Do not turn it into a landing page, add booking features or invent claims. Return the working page.
What was provided
The starting page already had search, filters, six workshops and detail dialogs. We supplied the page files, project/design notes and an existing chart. Codex followed the official Impeccable polish instructions alongside frontend-design guidance and its normal instructions. The evaluator knew earlier findings, so this was not a blinded first attempt or an isolated measure of Impeccable alone. The text below is the complete brief, not all supplied project files.
Read the complete text brief
Synthetic test material created by AI Labour Department for this evaluation. The organisation, sessions and booking details are fictional. Fieldnotes: Practical workshops for curious people. Purpose: browse six upcoming workshops, search by title or description, filter by topic, and read session details. This is a local session directory, not a booking service. Audience: students and early-career professionals choosing a short practical workshop. Keep the existing green-and-white identity. Improve the current interface, rather than replacing it with a marketing landing page. Preserve all workshop titles, descriptions, dates, durations, prices and locations exactly. Do not invent registrations, ratings, testimonials or availability. All sessions cost GBP 12. Dates are in October 2026; times are UK local time. 1. Make your first data chart | Data | 06 Oct 2026 | 10:00 | 90 minutes | Studio 2 Turn a small table into a clear chart and explain what the numbers do and do not show. 2. Write a clearer project update | Writing | 08 Oct 2026 | 14:00 | 60 minutes | Online Organise a project update around progress, decisions and the next steps. 3. Build a one-page portfolio | Design | 12 Oct 2026 | 10:00 | 120 minutes | Studio 1 Create a small portfolio page with a readable layout and a useful project description. 4. Read a research paper together | Research | 15 Oct 2026 | 16:00 | 90 minutes | Online Identify the question, method, findings and limitations in a supplied paper. 5. Turn notes into a short talk | Writing | 20 Oct 2026 | 14:00 | 60 minutes | Studio 2 Arrange your notes into a short talk with a clear opening and ending. 6. Make a dashboard easier to read | Design | 22 Oct 2026 | 10:00 | 90 minutes | Studio 1 Adjust the hierarchy, spacing and labels in an existing dashboard. Required interactions: case-insensitive search across titles and descriptions; a topic selector with All topics, Data, Writing, Design, Research; a live count of matching sessions; a meaningful empty state; a View details button for each session; a native dialog with the correct session details that can be closed by its button or Escape. Supplied image: sample-chart.png is an existing synthetic-data chart from the site's Scientific Agent Skills test, reused only as a workshop-material illustration. Do not describe it as an Impeccable-generated chart.
Before and after
Unedited screenshots of the original and refined page at matching widths. The chart was supplied with the input, not generated by Impeccable.
Phone (390px wide)
Desktop (1440px wide)
Tablet (768px wide)
What the result shows
More room for text
On phones, the price and details button move below the description. The workshop text uses the full available row instead of sharing it with a narrow action column.
Larger controls, working interactions
The smallest tested main control grew from 37 to 44 pixels high. Search and every topic filter still return the right sessions. All 36 dialog close attempts worked, and the phone keyboard checks passed.
Workshop information preserved
All six workshop descriptions, dates, times, durations, locations and GBP 12 prices stayed the same. The added full-size link points to the original supplied chart.
Small chart labels still need an extra step
The chart labels are still small in the desktop sidebar and phone view. Opening the full-size chart makes them readable, but adds an extra step. This is where the score loses five points.
More space also means more scrolling
At a 390-pixel screen width, the page grew from 2399 to 2811 pixels tall. The wider text area and larger controls also mean more scrolling.
How this example was scored
95/100 for this example. We deducted 5 points because chart labels remained small on the desktop and phone page, even though opening the original chart worked. Search, filtering, all session details, keyboard actions and information preservation passed the checks written before this run. This is not a score for visual beauty, privacy or untested features. One synthetic workshop directory, tested in Chromium at 1440, 768 and 390 pixels. This was a new run from the original page, after the earlier report was reviewed. The exact AI model was not recorded. The score applies to these checked requirements, not overall design quality or the whole Impeccable toolkit.
Five scoring dimensions
Passed checks receive 1 point, partly met checks 0.5, and failed checks 0. Checks outside this example are excluded, not counted as passes. The five dimension percentages are combined using the weights shown below.
Did it complete the task?
83.3%All three layouts keep the content and actions accessible. Chart labels remain small inline on desktop and phone; the full-size view works. This is the predeclared non-blocking readability deduction. Search, all four topic subsets and counts, the zero-result state and resetting to six workshops matched expectations at all three widths. Every session showed its matching information. All 36 close attempts worked: six sessions, two close methods, three screen widths.
Did it run without problems?
100.0%All three page layouts and the supplied image loaded; the tested interactions produced no uncaught browser errors. The official engine 0.1.3 matched its release checksum and engine-probe. The pinned official launcher explicitly selected that binary for context and the requested detector. The detector warned about the retained Arial font; no replacement executable or additional credentials were used.
Did it preserve the supplied information?
100.0%All six workshop records, prices, dates and UK-time notice remained correct in the page and dialogs. The original session data and behavior script are byte-identical. The page retains the no-bookings notice and adds no ratings, registrations or generated-chart claim. The chart remains the supplied image.
Did it do the documented task in this setup?
100.0%The result retains the green-and-white directory, all workshop material and its existing functionality. It is not a replacement marketing page. The session read the official Skill, polish and craft-floor instructions, ran context, refined local HTML/CSS and inspected the result with the requested detector and browser checks. No other Impeccable command is represented as tested.
Were the setup and use instructions clear?
100.0%The documented instructions provided the context and detector commands and the polish steps. The optional legacy-product migration notice did not block this local task. At phone width, search and topic controls are 48px high; all six details actions and all six tested close actions are 44px. Names, Tab reachability, visible focus and keyboard opening/closing were verified.
Limits of this example
- Other Impeccable commands: craft, shape, init, document, extract, critique, audit, bolder, quieter, distill, harden, onboard, animate, colorize, typeset, layout, delight, overdrive, clarify, adapt, optimize and live.
- Native mobile applications, browser extension, automatic edit hooks, other AI applications and other models.
- Real bookings, payments, external integrations, large applications, screen-reader software and non-Chromium browsers.
- Security/privacy guarantees and whether Impeccable outperforms the same model without the Skill.
- A blinded first attempt: the executor has seen earlier review findings. This new run uses the original baseline, not the earlier refined output.
Want to see more tests?
Tell us which module or task you would like us to test next.