impeccable 2.0.7 → 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.repo.md +8 -9
- package/bin/commands/skills.mjs +40 -34
- package/package.json +2 -2
package/README.repo.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Impeccable
|
|
2
2
|
|
|
3
|
-
The vocabulary you didn't know you needed. 1 skill,
|
|
3
|
+
The vocabulary you didn't know you needed. 1 skill, 18 commands, and curated anti-patterns for impeccable frontend design.
|
|
4
4
|
|
|
5
5
|
> **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles.
|
|
6
6
|
|
|
@@ -12,7 +12,7 @@ Every LLM learned from the same generic templates. Without guidance, you get the
|
|
|
12
12
|
|
|
13
13
|
Impeccable fights that bias with:
|
|
14
14
|
- **An expanded skill** with 7 domain-specific reference files ([view source](source/skills/impeccable/))
|
|
15
|
-
- **
|
|
15
|
+
- **18 steering commands** to audit, review, polish, distill, animate, and more
|
|
16
16
|
- **Curated anti-patterns** that explicitly tell the AI what NOT to do
|
|
17
17
|
|
|
18
18
|
## What's Included
|
|
@@ -31,29 +31,28 @@ A comprehensive design skill with 7 domain-specific references ([view skill](sou
|
|
|
31
31
|
| [responsive-design](source/skills/impeccable/reference/responsive-design.md) | Mobile-first, fluid design, container queries |
|
|
32
32
|
| [ux-writing](source/skills/impeccable/reference/ux-writing.md) | Button labels, error messages, empty states |
|
|
33
33
|
|
|
34
|
-
###
|
|
34
|
+
### 18 Commands
|
|
35
35
|
|
|
36
36
|
| Command | What it does |
|
|
37
37
|
|---------|--------------|
|
|
38
38
|
| `/impeccable teach` | One-time setup: gather design context, save to config |
|
|
39
|
+
| `/impeccable craft` | Full shape-then-build flow with visual iteration |
|
|
40
|
+
| `/impeccable extract` | Pull reusable components and tokens into the design system |
|
|
39
41
|
| `/audit` | Run technical quality checks (a11y, performance, responsive) |
|
|
40
42
|
| `/critique` | UX design review: hierarchy, clarity, emotional resonance |
|
|
41
|
-
| `/
|
|
42
|
-
| `/polish` | Final pass before shipping |
|
|
43
|
+
| `/polish` | Final pass, design system alignment, and shipping readiness |
|
|
43
44
|
| `/distill` | Strip to essence |
|
|
44
45
|
| `/clarify` | Improve unclear UX copy |
|
|
45
46
|
| `/optimize` | Performance improvements |
|
|
46
|
-
| `/harden` | Error handling, i18n, edge cases |
|
|
47
|
+
| `/harden` | Error handling, onboarding, i18n, edge cases |
|
|
47
48
|
| `/animate` | Add purposeful motion |
|
|
48
49
|
| `/colorize` | Introduce strategic color |
|
|
49
50
|
| `/bolder` | Amplify boring designs |
|
|
50
51
|
| `/quieter` | Tone down overly bold designs |
|
|
51
52
|
| `/delight` | Add moments of joy |
|
|
52
|
-
| `/extract` | Pull into reusable components |
|
|
53
53
|
| `/adapt` | Adapt for different devices |
|
|
54
|
-
| `/onboard` | Design onboarding flows |
|
|
55
54
|
| `/typeset` | Fix font choices, hierarchy, sizing |
|
|
56
|
-
| `/
|
|
55
|
+
| `/layout` | Fix layout, spacing, visual rhythm |
|
|
57
56
|
| `/overdrive` | Add technically extraordinary effects |
|
|
58
57
|
|
|
59
58
|
#### Usage Examples
|
package/bin/commands/skills.mjs
CHANGED
|
@@ -220,6 +220,18 @@ async function install(flags) {
|
|
|
220
220
|
}
|
|
221
221
|
}
|
|
222
222
|
|
|
223
|
+
// Clean up deprecated skills from previous versions
|
|
224
|
+
try {
|
|
225
|
+
const { cleanup } = await import('../../source/skills/impeccable/scripts/cleanup-deprecated.mjs');
|
|
226
|
+
const result = cleanup(root);
|
|
227
|
+
const total = result.deletedPaths.length + result.removedLockEntries.length;
|
|
228
|
+
if (total > 0) {
|
|
229
|
+
console.log(`Cleaned up ${total} deprecated skill(s) from previous versions.`);
|
|
230
|
+
}
|
|
231
|
+
} catch {
|
|
232
|
+
// Cleanup script not available -- skip
|
|
233
|
+
}
|
|
234
|
+
|
|
223
235
|
console.log(`\nDone! Run /${prefix}impeccable teach in your AI harness to set up design context.\n`);
|
|
224
236
|
}
|
|
225
237
|
|
|
@@ -356,45 +368,24 @@ function downloadFile(url, dest) {
|
|
|
356
368
|
|
|
357
369
|
async function update(flags = []) {
|
|
358
370
|
const yes = flags.includes('-y') || flags.includes('--yes');
|
|
359
|
-
// Try npx skills update first
|
|
360
|
-
console.log('Checking for skills manager...');
|
|
361
|
-
let noLockFile = true;
|
|
362
|
-
try {
|
|
363
|
-
const output = execSync('npx skills check', { encoding: 'utf8', timeout: 15000 });
|
|
364
|
-
noLockFile = output.includes('No skills tracked');
|
|
365
|
-
} catch {
|
|
366
|
-
// npx skills not available or errored
|
|
367
|
-
}
|
|
368
371
|
|
|
369
|
-
|
|
372
|
+
// Clean up deprecated skills from previous versions.
|
|
373
|
+
try {
|
|
374
|
+
const { cleanup } = await import('../../source/skills/impeccable/scripts/cleanup-deprecated.mjs');
|
|
370
375
|
const root = findProjectRoot();
|
|
371
|
-
const
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
console.log(`Detected "${prefix}" prefix, temporarily reverting for update...`);
|
|
376
|
-
undoPrefix(root, prefix);
|
|
377
|
-
}
|
|
378
|
-
|
|
379
|
-
console.log('Updating via npx skills...\n');
|
|
380
|
-
try {
|
|
381
|
-
execSync('npx skills update', { stdio: 'inherit' });
|
|
382
|
-
} catch (e) {
|
|
383
|
-
// Re-apply prefix even if update fails
|
|
384
|
-
if (prefix) renameSkillsWithPrefix(root, prefix);
|
|
385
|
-
process.exit(e.status ?? 1);
|
|
376
|
+
const result = cleanup(root);
|
|
377
|
+
const total = result.deletedPaths.length + result.removedLockEntries.length;
|
|
378
|
+
if (total > 0) {
|
|
379
|
+
console.log(`Cleaned up ${total} deprecated skill(s) from previous versions.\n`);
|
|
386
380
|
}
|
|
387
|
-
|
|
388
|
-
//
|
|
389
|
-
if (prefix) {
|
|
390
|
-
const count = renameSkillsWithPrefix(root, prefix);
|
|
391
|
-
console.log(`\nRe-applied "${prefix}" prefix to ${count} skills.`);
|
|
392
|
-
}
|
|
393
|
-
process.exit(0);
|
|
381
|
+
} catch {
|
|
382
|
+
// Cleanup script not available (e.g. running from npm package) -- skip
|
|
394
383
|
}
|
|
395
384
|
|
|
396
|
-
//
|
|
397
|
-
|
|
385
|
+
// Download the latest skills directly from impeccable.style.
|
|
386
|
+
// We skip `npx skills update` because it has a known upstream bug
|
|
387
|
+
// (vercel-labs/skills#775) where it can't find the lock file.
|
|
388
|
+
console.log('Checking for updates...\n');
|
|
398
389
|
|
|
399
390
|
const root = findProjectRoot();
|
|
400
391
|
const providers = findInstalledProviders(root);
|
|
@@ -473,6 +464,21 @@ async function update(flags = []) {
|
|
|
473
464
|
rmSync(tmpDir, { recursive: true, force: true });
|
|
474
465
|
rmSync(tmpZip, { force: true });
|
|
475
466
|
|
|
467
|
+
// Re-apply prefix if detected
|
|
468
|
+
const prefix = detectPrefix(root);
|
|
469
|
+
if (prefix) {
|
|
470
|
+
const count = renameSkillsWithPrefix(root, prefix);
|
|
471
|
+
if (count > 0) console.log(`Re-applied "${prefix}" prefix to ${count} skills.`);
|
|
472
|
+
}
|
|
473
|
+
|
|
474
|
+
// Run cleanup again to remove deprecated stubs from the fresh download
|
|
475
|
+
try {
|
|
476
|
+
const { cleanup: postCleanup } = await import('../../source/skills/impeccable/scripts/cleanup-deprecated.mjs');
|
|
477
|
+
postCleanup(root);
|
|
478
|
+
} catch {
|
|
479
|
+
// Not available -- skip
|
|
480
|
+
}
|
|
481
|
+
|
|
476
482
|
console.log(`Updated ${updated} skills across ${providers.length} provider(s).`);
|
|
477
483
|
console.log('Done!\n');
|
|
478
484
|
} catch (e) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "impeccable",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.1.1",
|
|
4
4
|
"author": "Paul Bakaus",
|
|
5
5
|
"description": "Design skills, commands, and anti-pattern detection for AI coding agents",
|
|
6
6
|
"keywords": [
|
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
"dev": "bun run server/index.js",
|
|
50
50
|
"preview": "bun run build && wrangler pages dev",
|
|
51
51
|
"deploy": "bun run build && wrangler pages deploy build/",
|
|
52
|
-
"test": "bun test tests/build.test.js tests/detect-antipatterns.test.js && node --test tests/detect-antipatterns-fixtures.test.mjs && node --test tests/detect-antipatterns-browser.test.mjs",
|
|
52
|
+
"test": "bun test tests/build.test.js tests/detect-antipatterns.test.js && node --test tests/detect-antipatterns-fixtures.test.mjs && node --test tests/detect-antipatterns-browser.test.mjs && node --test tests/cleanup-deprecated.test.mjs",
|
|
53
53
|
"prepack": "cp README.md README.repo.md && cp README.npm.md README.md",
|
|
54
54
|
"postpack": "cp README.repo.md README.md && rm README.repo.md",
|
|
55
55
|
"screenshot": "bun run scripts/screenshot-antipatterns.js",
|