Commit Graph

15 Commits

Author SHA1 Message Date
marcusjezweb bae7c5f7ae refactor: skills reference bin/ executables (#73)
Update product-showcase and image-processing SKILL.md to use capture-screenshots and img-process CLI as primary approach. Custom scripts become the fallback for complex operations. Closes #70.
2026-04-03 23:01:40 +11:00
Marcus Webb 936165298a refactor: inline references into final 4 skills — completes #65
- tanstack-start: 336 -> 543 lines, 3 refs removed
- vite-flare-starter: 128 -> 291 lines, 3 refs removed
- design-loop: 324 -> 535 lines, 3 refs removed
- google-chat-messages: 225 -> 393 lines, 2 refs removed

All 14 skills from #65 now have critical content inlined.
Closes #65.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-29 09:21:44 +11:00
Marcus Webb 30bc1fd736 refactor: inline critical references into tailwind-theme-builder SKILL.md
Inlined ModeToggle component, 18 gotchas, architecture deep-dive,
color variable flow diagrams, dark mode switching flow. 3 refs removed,
migration-guide.md kept as optional. SKILL.md: 173 -> 419 lines.

Part of #65 (3 of 14 skills). Delegated to sub-agent worker.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-29 09:04:35 +11:00
Marcus Webb 65d2a87cc3 add 3 new frontend skills + update CLAUDE.md and statusline
New skills: design-loop, design-system, walkthrough-video (frontend plugin).
CLAUDE.md updated: 59 -> 62 skills, inline-everything-critical guidance,
updated file structure docs. Statusline-npm improvements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-28 18:44:23 +11:00
Jeremy Dawes 6de4aefbc3 feat(product-showcase): deployment options, enquiry forms, SEO, additional pages
Deployment: Cloudflare Workers with Static Assets (recommended), Pages
drag-and-drop, or any static host. Custom domain guidance.

Enquiry forms: three patterns — Formspree (no backend), Worker endpoint
(SMTP2Go/Resend), Turnstile spam protection. Form field recommendations
and post-submission UX.

Additional pages: pricing, about, changelog, docs link, blog, privacy/
terms, status page — with guidance on when to include each.

SEO: per-page meta tags, OG images, canonical URLs, JSON-LD reference.

New quality rules: forms must submit somewhere, every page needs nav,
deploy to a real URL (not local files).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:49:57 +11:00
Jeremy Dawes 84a62fd704 feat(product-showcase): multi-page sites, animated GIF walkthroughs, agentic app patterns
Major rewrite — the skill now produces multi-page marketing websites,
not just single-page marketing:

Standard mode: Home + Features + How It Works pages with real screenshots
Thorough mode: Per-feature deep-dive pages, animated GIF walkthroughs,
use case scenario pages ("A day in the life of..."), comparison page

New: Animated GIF capture — record 2-4 second workflow sequences as GIFs
using Playwright frame capture + PIL. Shows the app actually working,
not just static screenshots.

New: Agentic app marketing patterns — before/after, timeline, result
showcase, side-by-side, magic moment GIFs. Copy tips for invisible AI
value ("Know every client's history" not "AI-powered CRM").

New: Per-feature pages with hero screenshot, how it works, why it
matters, power-user tips. Use case pages with story-driven scenarios.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 14:48:03 +11:00
Jeremy Dawes 61bdd74da8 feat: major app-docs upgrade + showcase mockup patterns
app-docs rewritten with:
- Exhaustive depth level (150+ screenshots, publishable HTML suite)
- Per-page documentation template with What You'll See / What You Can Do / How To
- Supporting sections: getting started, navigation guide, keyboard shortcuts, troubleshooting, admin guide
- HTML output option with TOC sidebar and print CSS
- Workflow diagrams and annotated screenshot patterns
- Quality bar: "a new user can complete any task by following the guide"
- Mockup and diagram techniques alongside screenshots

product-showcase: added mockup + screenshot mix guidance with CSS phone
frame for mobile screenshots, guidance on when to use real screenshots
vs simplified mockups for different sections.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 15:52:59 +11:00
Jeremy Dawes 5a34d9de7a feat(product-showcase): depth levels, premium techniques, more sections
Depth levels: quick (hero + features), standard (full showcase), thorough
(every section including dark mode, shortcuts, before/after, integrations).

New optional sections: before & after comparison, dark mode showcase,
keyboard shortcuts / power features, integrations ecosystem, open source.

Premium techniques: screenshot enhancement tips (clean data, consistent
size, highlight the action), visual storytelling (lead with dashboard,
show results not forms, progressive reveal), CSS-only animations (fade-in,
hero float), gradient accents from app's brand colour.

Value proposition extraction: benefit-focused copy ("Find anything in
seconds") not feature descriptions ("Search functionality").

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 15:39:52 +11:00
Jeremy Dawes cc605fc7e6 feat: add stripe-payments skill + fix argument hints across all commands
stripe-payments: Checkout Sessions, Payment Intents, subscriptions,
webhooks (with constructEventAsync for Workers), customer portal,
pricing pages. Decision table for which API to use. Cloudflare Workers
gotchas. No MCP server needed.

Argument hint cleanup: removed [url] and [file-path] from hints —
replaced with meaningful choices (depth levels, modes, purposes).
The URL/file is auto-detected, the hint shows what the user decides.

product-showcase: added depth levels (quick/standard/thorough).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 22:47:25 +11:00
Jeremy Dawes dedae3b589 feat: add react-patterns, design-review, and react-native skills
react-patterns: 50+ React 19 rules ranked by impact — waterfalls,
bundle size, composition architecture, re-render prevention, React 19
APIs, Vite + Cloudflare specifics. Self-contained (no separate rule files).

design-review: Visual design quality checker — layout, typography,
spacing, colour, hierarchy, consistency, interaction patterns, responsive
behaviour. Companion to ux-audit (usability) — this checks if it looks
professional.

react-native: React Native + Expo patterns — list performance (FlatList/
FlashList), Reanimated animations, Expo Router navigation, UI patterns,
images, state/data, Expo workflows (EAS Build, EAS Update), testing.
Starting point for mobile development.

Inspired by vercel-labs/agent-skills but self-contained in our format.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 22:13:19 +11:00
Jeremy Dawes 7f1f77baa3 feat: add slash commands for all 51 skills + fix compatibility fields
Created 45 command files with descriptive argument-hints so every skill
has a /plugin:skill-name shortcut. Added compatibility: claude-code-only
to 17 skills that require Bash/filesystem/browser (d1-migration, db-seed,
project-docs, git-workflow, landing-page, shadcn-ui, tailwind-theme-builder,
ai-image-generator, color-palette, favicon-gen, icon-set-generator, etc).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 21:24:58 +11:00
Jeremy Dawes 049f49a0ca feat: add depth levels to ux-audit + new app-docs and product-showcase skills
ux-audit: add quick/standard/thorough depth levels. Thorough mode runs
autonomously overnight — multiple personas, all pages, all states,
resilience testing, comprehensive report with screenshots.

app-docs: browse a running app, screenshot every screen, produce a
complete user guide with step-by-step instructions.

product-showcase: explore a running app, capture key screens, generate
a marketing site (single HTML) with real screenshots in browser-frame
mockups, feature grid, how-it-works, and CTAs.

49 → 51 skills.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 22:40:35 +11:00
Jeremy Dawes cfad81649a feat: add 5 new skills — project-docs, landing-page, db-seed, ai-image-generator, social-media-posts
New skills batch (44 → 49 skills, 10 → 11 plugins):
- project-docs: generate ARCHITECTURE.md, API_ENDPOINTS.md, DATABASE_SCHEMA.md from codebase
- landing-page: single-file deployable HTML with Tailwind CDN
- db-seed: realistic seed scripts for D1/Drizzle with FK ordering and batch limits
- ai-image-generator: Gemini/GPT image gen with 5-part prompting framework
- social-media-posts: platform-formatted posts for LinkedIn, FB, Instagram, Reddit

New plugin: social-media

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-15 09:53:05 +11:00
Jeremy Dawes 589d793f96 fix: make all skills self-contained for external users
Remove dependencies on Jez's personal config that would break for
other users installing these plugins:

HIGH (would break):
- gemini-peer-review, gemini-image-gen: replace Vault MCP API key
  retrieval with generic env var + aistudio.google.com link
- vite-flare-starter: remove "Jez's" language, generic account prompt
- tanstack-start: generic Cloudflare account prompt
- shopify-setup, wordpress-setup: replace Vault MCP credential
  storage with generic "your preferred secrets manager"

MEDIUM (would confuse):
- github-release: remove ~/.claude/rules/ reference, inline guidance
- google-chat-messages: replace Jezweb favicon URL, Bitwarden ref
- gemini-guide: make local doc cache optional, prioritise GitHub +
  WebFetch sources that anyone can access
- project-health: move GEMINI_API_KEY from Universal Base to AI/GPU
  preset, genericise MCP server examples
- aussie-business-english: replace "Jez" with "[Your name]" in examples
- responsiveness-check: soften playwright-cli requirement
- favicon-gen: document ImageMagick prerequisite
- skill-creator: add "Skills Must Be Self-Contained" section,
  genericise marketplace example
- shadcn-ui: replace "Jez" placeholder in recipes
- Python scripts: replace Vault error messages with aistudio.google.com

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 03:37:48 +11:00
Jez a1b085f3e9 feat: restructure into 8 plugins, add Shopify store management
Move all 24 skills from flat skills/ directory into 7 category-based
plugins under plugins/. Add new Shopify plugin with 3 skills
(shopify-setup, shopify-products, shopify-content) for Admin API
access, product CRUD/bulk import, and content management.

Update marketplace.json to new plugin format, fix script paths in
skill-creator, context-manager, and vite-flare-starter SKILL.md files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 16:18:17 +11:00