mirror of https://github.com/pbakaus/impeccable.git synced 2026-09-15 07:36:50 +03:00

Files

T

Paul BakausandClaude Opus 4.6 b0f44f83c6 Consolidate 18 skills into 1 /impeccable skill with 20 commands

Biggest change in a while. Users previously had 18 standalone skill
entries cluttering their /menu; now they have one entry (/impeccable)
that routes to 20 specialized commands via argument dispatch. The pin
mechanism (/impeccable pin audit) restores standalone shortcuts on
demand for commands users hit all the time.

## Architecture

- Single /impeccable skill with command router section in SKILL.md
- 20 commands served via reference files under source/skills/impeccable/reference/
- /impeccable pin <command> creates a lightweight redirect shim so users
  who prefer /audit, /polish, etc. can still have them
- Context gathering (teach) auto-runs on first use
- command-metadata.json is the single source of truth for command
  descriptions, argument hints, and relationships

## Site rewrite

- Docs URL: /skills renamed to /docs (with /skills permanent redirects)
- Homepage hero frames Impeccable as "one skill with 20 commands"
- "Get Started" split into 50/50 install + how-to-use with editorial
  numbered steps, /impeccable shown as the home command with three modes
- New /docs overview: home command hero card + dense category rows
  matching the old cheatsheet density, with leads-to/pairs-with/
  combines-with relationship metadata served from a shared source
- Cheatsheet merged into /docs, /cheatsheet redirects
- Magazine spread and mobile cards show /impeccable as a stacked
  namespace label above the command name at full display size
- Periodic table updated with craft/teach/extract as first-class cells
- Skill detail pages generate from reference files, with an editorial
  wrapper per command for tagline + body
- Tutorials and anti-patterns pages updated to use /impeccable <cmd>

## Build system

- Dead code removed (scripts/lib/transformers/shared.js)
- Build log wording fixed ("1 skill" not "1 skills (1 user-invocable)")
- generateApiData fallback branch removed (throws loudly if metadata
  missing instead of silently degrading)
- Commands API includes editorial tagline alongside the long description;
  UI surfaces prefer tagline for human display, description for auto-
  trigger keyword matching

## Gitignore

- Added .claude/scheduled_tasks.lock, .claude/settings.local.json to
  ignore list (local Claude Code state that should not be tracked).
- Harness skill directories (.claude/skills/, .agents/skills/, etc.)
  remain tracked by design: npx skills reads them from this repo at
  install time and they enable clean submodule use.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-10 19:45:17 -07:00

2.6 KiB

Raw Blame History

Teach Flow

One-time setup that gathers design context for a project. Design without context produces generic output, so every other command reads this file before doing any work.

Step 1: Explore the Codebase

Before asking questions, thoroughly scan the project to discover what you can:

README and docs: Project purpose, target audience, any stated goals
Package.json / config files: Tech stack, dependencies, existing design libraries
Existing components: Current design patterns, spacing, typography in use
Brand assets: Logos, favicons, color values already defined
Design tokens / CSS variables: Existing color palettes, font stacks, spacing scales
Any style guides or brand documentation

Note what you've learned and what remains unclear.

Step 2: Ask UX-Focused Questions

{{ask_instruction}} Focus only on what you couldn't infer from the codebase:

Users & Purpose

Who uses this? What's their context when using it?
What job are they trying to get done?
What emotions should the interface evoke? (confidence, delight, calm, urgency, etc.)

Brand & Personality

How would you describe the brand personality in 3 words?
Any reference sites or apps that capture the right feel? What specifically about them?
What should this explicitly NOT look like? Any anti-references?

Aesthetic Preferences

Any strong preferences for visual direction? (minimal, bold, elegant, playful, technical, organic, etc.)
Light mode, dark mode, or both?
Any colors that must be used or avoided?

Accessibility & Inclusion

Specific accessibility requirements? (WCAG level, known user needs)
Considerations for reduced motion, color blindness, or other accommodations?

Skip questions where the answer is already clear from the codebase exploration.

Step 3: Write Design Context

Synthesize your findings and the user's answers into a ## Design Context section:

## Design Context

### Users
[Who they are, their context, the job to be done]

### Brand Personality
[Voice, tone, 3-word personality, emotional goals]

### Aesthetic Direction
[Visual tone, references, anti-references, theme]

### Design Principles
[3-5 principles derived from the conversation that should guide all design decisions]

Write this section to .impeccable.md in the project root. If the file already exists, update the Design Context section in place.

Then {{ask_instruction}} whether they'd also like the Design Context appended to {{config_file}}. If yes, append or update the section there as well.

Confirm completion and summarize the key design principles that will now guide all future work.

2.6 KiB Raw Blame History