Commit Graph
182 Commits
Author SHA1 Message Date
Paul BakausandClaude Opus 4.6 2bf7fce2d6 Bump version to 1.5.1
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 08:38:38 -07:00
Paul BakausandGitHub 027bd0a9a6 Merge pull request #44 from pbakaus/fix/typeset-app-instructions
Fix typeset skill: distinguish fluid vs fixed type for apps
2026-03-17 08:37:01 -07:00
Paul BakausandClaude Opus 4.6 e818c14ff1 Distinguish fluid vs fixed type scales for apps vs content pages
The typeset skill universally recommended fluid sizing via clamp(),
but no major app design system (Material, Polaris, Primer, Carbon)
uses fluid type in product UI. Now recommends fixed rem scales for
app UIs and reserves fluid type for marketing/content page headings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 08:18:15 -07:00
Paul BakausandClaude Opus 4.6 a3633c66f0 Fix split-compare clip-path angle to match divider's skewX(-10deg)
The divider uses a fixed CSS angle (skewX(-10deg)) but the clip-path
mask used a fixed percentage offset (skewOffset=8), which only matches
at one specific aspect ratio. Now computes skewOffset dynamically from
the container's actual dimensions via ResizeObserver.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 08:04:24 -07:00
Paul BakausandGitHub b5af865d84 Merge pull request #41 from pbakaus/feat/update-instructions
Add update instructions to install section and FAQ
2026-03-16 16:21:47 -07:00
Paul BakausandClaude Opus 4.6 f088143ec2 Use npx skills update/check commands for updates
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 16:20:27 -07:00
Paul BakausandClaude Opus 4.6 52e0d20a1b Add update instructions to install section and FAQ
- Install section tip now mentions re-running the same command to update
- New FAQ entry: "How do I update to the latest version?" covering
  npx skills, Claude Code plugin marketplace, and manual ZIP
- Notes that .impeccable.md is preserved across updates

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 16:18:52 -07:00
Paul BakausandGitHub fef91b6375 Merge pull request #38 from pbakaus/feat/typeset-arrange-skills
Add /typeset and /arrange skills
2026-03-16 16:11:42 -07:00
Paul BakausandClaude Opus 4.6 eede321458 Trim changelog to user-facing highlights
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 15:59:09 -07:00
Paul BakausandClaude Opus 4.6 8863e5d07b Bump version to 1.5.0, add changelog entry
New in v1.5.0:
- 3 new skills: /typeset, /arrange, /overdrive (beta)
- Shared Context Gathering Protocol with .impeccable.md
- teach-impeccable writes provider-agnostic context
- Deep linking to commands (#cmd-overdrive etc.)
- JS-powered demo infrastructure with live laser signature

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 15:58:25 -07:00
Paul BakausandClaude Opus 4.6 61eaceefdd Add overdrive ASCII banner on skill activation
Starts the response with a distinctive speed-line banner
to set the tone for the skill.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 15:51:55 -07:00
Paul BakausandClaude Opus 4.6 fcc70fd4c9 Require direction confirmation and browser iteration for overdrive
Two new mandatory sections in the skill:

1. Propose Before Building — must present 2-3 directions with
   trade-offs and get user confirmation before writing code. This
   skill has the highest misfire potential.

2. Iterate with Browser Automation — must use browser tools to
   visually verify effects and iterate. Complex effects never work
   on the first try.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 11:45:30 -07:00
Paul BakausandClaude Opus 4.6 9bdb836903 Mark overdrive as beta, remove product-level suggestions
Skill changes:
- Remove real-time collaboration section (product decision, not UI)
- Remove service workers / offline-first (product decision)
- Remove SharedArrayBuffer (too niche)
- Replace "application architecture" section with "performance-critical
  UI" — focused on making existing features feel fast
- Add explicit note: this skill enhances how UI FEELS, not what a
  product DOES

Beta label:
- Add betaCommands list to data.js
- Show BETA badge on /overdrive in command palette
- Show β symbol on periodic table element
- Show BETA badge on cheatsheet page

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 11:42:59 -07:00
Paul BakausandClaude Opus 4.6 5b5bba6488 Add .wrangler/ to gitignore
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 11:29:07 -07:00
Paul BakausandClaude Opus 4.6 8427deac3e Improve typeset and arrange demos
Typeset: make the before worse (all text same size/color = no
hierarchy) and the after more dramatic (bigger heading, more size
contrast). The transformation should be instantly visible on hover.

Arrange: fix heading split (eyebrow+heading was a typeset change,
not arrange) — keep it as a single heading to stay on-brand.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 11:25:54 -07:00
Paul BakausandClaude Opus 4.6 577c9c872c Overdrive laser demo, deep link support, and split-compare fix
Demo:
- Laser-etched "Paul Bakaus" signature drawn in real-time on dark
  surface, adapted from pbakaus/shaders laser-precision
- Two-canvas architecture: persistent burn canvas + cleared-per-frame
  spark overlay to prevent pixel accumulation
- Smooth quadraticCurveTo rendering for fluid signature strokes
- Sparks with motion trails, multi-layer tip glow

Infrastructure:
- Add init() support for command demos — JS can now execute after
  demo HTML is inserted into the DOM
- Fix split-compare retriggerAnimations to not destroy canvas elements
  (clone-and-replace for CSS-only demos, individual retrigger when
  canvas is present)
- Add deep linking to commands (#cmd-overdrive etc.) with hash
  tracking and initial load support
- Remove auto-#hero hash — hero is the default state

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 11:13:05 -07:00
Paul BakausandClaude Opus 4.6 8bb0017752 fix: overdrive demo works with hover slider, no AI slop
The demo must be purely visual (hover slider reveals after state,
no clicking). New demo shows standard rectangular card vs organic
blob-shaped composition — the visual difference is instant and
communicates "beyond normal CSS" without animation or interaction.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 07:24:55 -07:00
Paul BakausandClaude Opus 4.6 234f5b7051 Rewrite /overdrive skill from scratch
The original was an effects-only skill biased toward creative
portfolios and visual spectacle. The rewrite addresses:

1. Scope: now covers ALL forms of technical ambition — performance
   (virtual scrolling, WASM, Web Workers), interaction patterns
   (View Transitions on dialogs, spring physics), real-time collab
   (WebSockets, SharedArrayBuffer), and data visualization — not
   just shaders and particles.

2. Browser support: removed Houdini Paint API (Chromium-only),
   removed navigator.vibrate() (Safari never shipped, Firefox
   dropped), added support notes for each technology tier.

3. Bias corrections: removed creative-portfolio-only framing,
   removed "pick ONE hero moment" dogma, added examples for
   functional UI (tables, forms, dialogs) and app architecture.

4. Structure: organized toolkit by what you're trying to achieve
   (make transitions cinematic, push performance boundaries) not
   by technology name.

5. Demo: replaced purple gradient AI slop with a structural
   before/after showing view-transition-name on project cards.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 20:08:15 -07:00
Paul BakausandClaude Opus 4.6 731c0ceaf7 feat: add /overdrive skill for technically extraordinary effects
New skill that pushes interfaces past conventional limits with
bleeding-edge browser APIs: WebGPU shaders, scroll-driven animations,
View Transitions, generative art, spring physics, and more.

Key design decisions:
- Strong "when to use / when not to" guardrails
- Progressive enhancement is non-negotiable
- "Pick ONE hero moment" philosophy — restraint in choosing where
- The extraordinary/gimmicky line defined explicitly
- prefers-reduced-motion respect required

Also updates all counts to 20 commands across website, docs, and
plugin metadata.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 19:58:02 -07:00
Paul BakausandClaude Opus 4.6 9dd959abe2 Refine /arrange skill based on review feedback
- Replace prescriptive 4pt px grid with flexible guidance (framework
  scales, rem tokens, custom systems — consistency matters, not values)
- Add Flex vs Grid guidance — don't default to Grid when Flex is simpler
- Soften hierarchy advice: fewest dimensions needed, not "combine all"
- Remove margin-left optical trick (confusing, too niche)
- Remove touch target advice (belongs in /adapt and /audit)
- Add qualifier to icon centering (only adjust if confident)
- Fix position hierarchy to be about reading flow awareness, not rules
- Change hero metric from NEVER to nuanced DON'T (legitimate for real
  data, problematic as default template)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 19:40:22 -07:00
Paul BakausandClaude Opus 4.6 45bcf7b485 Add typeset and arrange to website, docs, and all metadata
- Add to data.js (process steps, categories, relationships)
- Add to framework-viz.js (periodic table symbols and numbers)
- Create before/after demos for both commands
- Update command count 17→19 across all locations:
  index.html, cheatsheet.html, README, NOTICE, AGENTS,
  plugin.json, marketplace.json
- Add critique→typeset/arrange in relationship flow
- Add "Adding New Skills" checklist to CLAUDE.md so future
  skill additions don't miss any locations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 19:26:35 -07:00
Paul BakausandClaude Opus 4.6 059ab1b1e6 feat: add /typeset and /arrange skills for typography and layout
Two new skills that expose frontend-design's typography and spatial
design references as actionable, diagnostic workflows:

- /typeset: assess and improve font choices, hierarchy, sizing, weight
  consistency, and readability (closes #26)
- /arrange: assess and improve layout, spacing, visual rhythm, and
  grid structure

Both follow the established skill pattern (assess → plan → execute →
verify) with MANDATORY PREPARATION and context gathering.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 19:13:53 -07:00
Paul BakausandGitHub f3f4f9056a Merge pull request #37 from pbakaus/refactor/shared-context-gathering-protocol
Extract shared Context Gathering Protocol for design skills
2026-03-15 18:58:18 -07:00
Paul BakausandClaude Opus 4.6 318a32476a Strengthen context gathering to prevent skipping teach-impeccable
The AI was inferring context from the codebase instead of running
teach-impeccable on cold start. Two changes:

1. Protocol in frontend-design now explicitly says "you cannot infer
   context by reading the codebase" and marks teach-impeccable as
   REQUIRED, not just suggested
2. Every skill's MANDATORY PREPARATION now reinforces: "if no design
   context exists yet, you MUST run teach-impeccable first"

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:48:18 -07:00
Paul BakausandClaude Opus 4.6 ff65176cec fix: remove redundant "design system" extra from normalize
Normalize already has its own "Discover the design system" step in
its Plan section that handles this. No need to duplicate it in the
preparation block.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:37:56 -07:00
Paul BakausandClaude Opus 4.6 ffa0d11da8 fix: remove product-level context from distill's preparation
"What's essential vs nice-to-have" is product prioritization, not
design context. The protocol already covers audience and use cases.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:36:47 -07:00
Paul BakausandClaude Opus 4.6 bac8696851 fix: correct AskUserQuestionTool to AskUserQuestion tool
The Claude Code tool is called AskUserQuestion, not AskUserQuestionTool.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:36:17 -07:00
Paul BakausandClaude Opus 4.6 67daf2bf17 Inline context gathering protocol into frontend-design SKILL.md
Moves the protocol from a separate reference file directly into
frontend-design's main SKILL.md to avoid two-level indirection
(skill → frontend-design → reference file) that could cause the
AI to miss it. Also fixes leftover "shipping timeline" in the
built polish output.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:34:15 -07:00
Paul BakausandClaude Opus 4.6 247bf2caaf refactor: extract shared Context Gathering Protocol for all design skills
Centralizes the duplicated ~15-line MANDATORY PREPARATION blocks from
10 skills into a single shared reference file in frontend-design. Since
all skills already depend on frontend-design, the protocol is
automatically available without build system changes.

Key changes:
- New reference: frontend-design/reference/context-gathering.md with
  3-tier gathering: check instructions → check .impeccable.md → auto-
  invoke teach-impeccable
- teach-impeccable now writes to .impeccable.md (provider-agnostic),
  optionally also to the provider config file
- 8 existing MANDATORY PREPARATION blocks replaced with 1-line pointers
- 4 skills that lacked context gathering now have it (adapt, clarify,
  polish, normalize)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 18:27:44 -07:00
Paul BakausandGitHub 8108534d4c Merge pull request #34 from rahuljordashe/fix/audit-findings
Fix missing context gathering and AI-slop copy in 3 skills
2026-03-15 17:58:32 -07:00
Paul BakausandGitHub dc38661021 Merge pull request #36 from AliFozooni/codex/fix-opencode-pi-downloads
Fix missing OpenCode and Pi download support
2026-03-15 17:53:55 -07:00
AliFozooni 6d8c851c25 Fix missing OpenCode and Pi downloads 2026-03-15 12:22:53 -07:00
Rahul JordasheandClaude Opus 4.6 ee9ecd570b Fix missing context gathering and AI-slop copy in 3 skills
critique:
- Add MANDATORY PREPARATION block with context gathering and
  {{ask_instruction}} — it was the only skill with a MANDATORY
  PREPARATION section in other skills that lacked one
- Enforce frontend-design skill loading with "Do NOT proceed until..."

onboard:
- Add MANDATORY PREPARATION block — same gap as critique, onboard
  jumped straight to assessment without gathering context first
- Add frontend-design skill loading

delight:
- Replace cliched loading messages ("Herding pixels", "Teaching robots
  to dance", "Consulting the magic 8-ball") with product-specific
  examples — these are exactly the kind of AI-generated copy the
  suite's own anti-slop philosophy warns against
- Add explicit WARNING against these cliched patterns
- Change "Checkboxes that bounce" to "scale pulse" — bounce easing
  contradicts the suite's consistent stance against bounce/elastic
  curves (documented in motion-design reference and every skill
  that mentions easing)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 16:08:04 +05:30
Paul BakausandGitHub 3c3ee6b4f2 Merge pull request #30 from glacierphonk/add-opencode-tests
test: add missing OpenCode transformer tests
2026-03-14 15:46:53 -07:00
Paul BakausandGitHub 400c22eb20 Merge pull request #31 from glacierphonk/fix-notice-command-count
docs: fix stale command count in NOTICE.md
2026-03-14 15:46:05 -07:00
Paul BakausandGitHub 2c1f7d95a3 Merge pull request #32 from glacierphonk/docs-develop-newer-providers
docs: update DEVELOP.md to reflect current architecture
2026-03-14 15:19:38 -07:00
GlacierPhonk 8d4f65f351 docs: update DEVELOP.md to reflect current architecture
The contributor guide had fallen behind the codebase in several ways:

- Documented source/commands/ which no longer exists (skills-only now)
- Only described 4 providers (Cursor, Claude Code, Gemini, Codex) —
  added Agents, Kiro, OpenCode, Pi
- Cursor described as "no frontmatter support" but it now uses Agent
  Skills with YAML frontmatter
- "What Gets Generated" diagram showed old command-based output paths
- Build system described as "single ~170-line script" but is now modular
  (scripts/lib/transformers/*.js)
- Referenced dist/ as committed but it's now gitignored
- Key Functions list missing 4 transformer functions
- Source Format missing user-invokable and args fields
- Referenced npm instead of bun in troubleshooting
2026-03-14 22:04:52 +01:00
GlacierPhonk 463618127e docs: fix stale command count in NOTICE.md
NOTICE.md said 15 steering commands but there are now 17 user-invokable
skills. README.md and AGENTS.md already have the correct count.
2026-03-14 21:58:49 +01:00
GlacierPhonk c54337c4fa test: add missing OpenCode transformer tests
Every other provider transformer (cursor, claude-code, gemini, codex,
agents, kiro, pi) has a dedicated test file, but OpenCode was missing.

Adds 23 tests covering directory structure, frontmatter fields (including
args, allowed-tools, user-invokable, compatibility, metadata), placeholder
replacement, reference file handling, prefix/suffix options, skill
cross-reference prefixing, directory cleanup, and log output.
2026-03-14 21:56:43 +01:00
Paul BakausandGitHub 15332dd293 Merge pull request #28 from whchi/main
fix opencode build
2026-03-12 20:24:04 -07:00
Dylan 7239921ab8 opencode use correct replacement 2026-03-13 11:10:27 +08:00
Paul BakausandClaude Opus 4.6 46c48def1a Bump version to v1.3.0, update changelog
- Added OpenCode provider support
- Added Pi provider support
- Recategorized /onboard as an enhancement command

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 11:49:08 -07:00
Paul BakausandClaude Opus 4.6 7310d521f6 fix: correct Cloudflare Pages project name in wrangler.toml
Project name was "impeccable-style" but the actual CF Pages project
is "impeccable", causing deploy failures.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 11:45:07 -07:00
Paul BakausandClaude Opus 4.6 af69a189e3 perf: add cache headers for static assets on Cloudflare Pages
- Hashed JS/CSS bundles: immutable, 1 year cache
- Images/logos/SVGs: 1 week cache with 1 day stale-while-revalidate
- HTML pages: browser revalidates, CDN caches 1h
- ZIP downloads: 1h cache
- API routes: unchanged (CDN 24h)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 11:26:28 -07:00
Paul BakausandClaude Opus 4.6 e5083bbe47 fix: self-host provider logos instead of hotlinking logo.dev
Downloaded all provider logos locally to public/assets/ to eliminate
external dependency on logo.dev API, which was hitting rate limits.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 11:24:35 -07:00
Paul BakausandClaude Opus 4.6 bb5ba2f305 feat: add Pi provider support, fix community health files, recategorize /onboard
- Add first-class Pi (pi.dev) provider with transformer, tests, and build integration
- Fix CODEOWNERS username (@paulbakaus → @pbakaus)
- Add missing providers to issue/PR templates (Copilot, Kiro, OpenCode, Pi)
- Add Pi and OpenCode logos to homepage hero and install sections
- Move /onboard from "system" to "enhancement" category
- Update README and DEVELOP.md with all supported providers

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 11:21:09 -07:00
Paul BakausandGitHub 599df3bb81 Merge pull request #18 from VaishnavGunjari/improvements
chore: add GitHub community health files
2026-03-12 09:56:16 -07:00
Paul BakausandGitHub e0a66a1e61 Merge pull request #27 from hamshad/feat/opencode-support
feat: add OpenCode provider support to build system
2026-03-12 09:49:46 -07:00
hamshad 506957487f feat: add OpenCode provider support to build system
- Created opencode transformer in scripts/lib/transformers/opencode.js
- Added opencode placeholders to scripts/lib/utils.js
- Integrated opencode into build.js and universal assembly
- Updated README.md and scripts/lib/transformers/index.js with OpenCode support
2026-03-12 16:30:15 +05:30
Vaishnav Gunjari 38fdc991c5 chore: remove FUNDING.yml and ci.yml, fix PR template checklist 2026-03-11 10:42:54 +05:30