Commit Graph

87 Commits

Author SHA1 Message Date
Marcus Webb c1e8dd19c7 feat(dev-tools): add vitest skill — test setup for Workers, React, Node
Rebuilt from v1 archive as a proper v2 skill that produces working test
infrastructure. Detects project type, generates vitest.config.ts, test
setup, utilities, sample tests, and package.json scripts. Covers mocking
patterns, coverage, workspace config, and Jest migration.

Prompted by issue #69 (Dispatch discoverability).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-30 11:18:27 +11:00
Jeremy Dawes f69bb4f113 chore: remove basalt plugin — moved to team-skills repo
Basalt Cortex depends on Gmail and Google Chat MCP servers, making it
team-specific rather than publicly shareable. Fully removed from
claude-skills (not just a stub). Install from jezweb/team-skills instead.

10 plugins, 59 skills.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 23:23:39 +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 312943e509 feat: kill dev-session, make roadmap the execution engine
BREAKING: dev-session skill removed. Its useful bits are now in roadmap.

Roadmap skill now has four modes:
- plan: generate the roadmap (was the only mode before)
- start: begin executing from phase 1, don't stop until done or stuck
- resume: pick up from the last session, keep going
- status: show progress across phases

Execution rules: commit at phase boundaries, deploy after each phase,
quick audit between phases, thorough audit + onboarding-ux + project-docs
after the final phase. Only stop for blockers that need human input.

Progress tracked directly in ROADMAP.md with checked tasks and completed
phase markers — no separate SESSION.md needed.

dev-session was a 200K-era survival tool. At 1M context, the roadmap
itself is the session state.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 14:13:24 +11:00
Jeremy Dawes 8cb92d183f feat: add roadmap skill — comprehensive phased delivery plans for entire apps
Produces a ROADMAP.md detailed enough that "build phase N" is a complete
instruction for Claude Code. Includes: vision, stack decisions, complete
data model upfront, 4-8 phases with task checklists grouped by layer,
schema evolution map, API surface map, build order table, and
"deliberately not building" scope control.

Designed for all-day autonomous execution — each phase is independently
deployable with a definition of done. Pairs with deep-research (input)
and fork-discipline/ux-audit/onboarding-ux (post-phase checks).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 13:00:30 +11:00
Jeremy Dawes c3ab785ca2 feat: add cloudflare-api skill + improve deep-research argument hints
cloudflare-api: Hit the Cloudflare REST API directly for operations that
wrangler and MCP can't handle well. Covers bulk DNS, custom hostnames,
email routing, cache purge, WAF rules, redirect rules, zone settings,
Worker routes, and GraphQL analytics. Produces curl commands or scripts.
Not a docs mirror — workflow recipes for real operations.

deep-research: Updated argument hints to explain what focused/wide/deep
actually mean inline, so you don't have to remember.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 12:54:22 +11:00
Jeremy Dawes 880c4228c4 feat: add fork-discipline skill — audit core/client boundary in multi-client projects
Three modes:
- audit: map the boundary, find violations (hardcoded client checks,
  config replacement, scattered client code, missing extension points,
  migration conflicts), produce a health score and report
- document: generate FORK.md documenting the boundary and how to add clients
- refactor: concrete steps to move client code out of core, replace client
  checks with feature flags, implement config merge, add extension points

Includes the "right time to run" guide: don't refactor at 1 client,
audit at 2, full refactor at 3+.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 11:04:43 +11:00
Jeremy Dawes b2355ac49e feat: add onboarding-ux skill — audit and generate in-app user guidance
Audits a web app for onboarding gaps (empty states, missing guidance,
feature discoverability, contextual help), then generates the actual
content and code to fix them:

- Empty state components with copy and CTAs
- Welcome banner or onboarding checklist
- Feature tour configuration (react-joyride pattern)
- Tooltip content map for every complex field
- Contextual hints (dismissable, shown once)
- Onboarding-quality seed data
- Help/FAQ page content

Pairs with ux-audit: audit finds problems, onboarding-ux builds solutions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 08:05:21 +11:00
Jeremy Dawes 397e8cbcfb feat: replace knowledge-cortex with basalt plugin + add deep-research skill
BREAKING: knowledge-cortex plugin removed. Replace with basalt plugin.
- /basalt:basalt-cortex replaces /knowledge-cortex:cortex-mine and cortex-query
- Basalt format: Obsidian-compatible markdown with YAML frontmatter (not JSONL)
- Multi-source: Gmail, Google Chat, Slack, Drive, local files, MCP, web, calendar
- Pattern-based teaching (no shipped scripts)
- References: basalt-format.md, source-patterns.md, prefilter-patterns.md, sync-patterns.md

NEW: deep-research skill in dev-tools
- Deep research and discovery before building something new
- Three depths: focused (30 min), wide (1-2 hours), deep (3-6 hours)
- Local exploration, competitor analysis, ecosystem signals, future-casting
- Produces comprehensive research brief to .jez/artifacts/

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 00:32:08 +11:00
Jeremy Dawes fe3132c306 Add nemoclaw-setup skill: NVIDIA NemoClaw agent platform installation guide
Comprehensive setup skill covering Docker cgroup fixes, OpenShell installation,
sandbox creation, persistent port forwarding with health checks, Cloudflare
Tunnel remote access, workspace configuration, and workarounds for known bugs
(device auth, token mismatch, rate limiting). Based on real-world setup experience
on NVIDIA Grace Hopper GX10.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 21:32:46 +11:00
Jeremy Dawes 680f9b6453 feat: add parcel-tracking skill for Australian couriers
Searches Gmail for dispatch emails, identifies carriers from tracking
number formats, builds direct tracking links for AusPost, StarTrack,
Sendle, DHL, FedEx, UPS, and provides paste-and-track links for Aramex,
CouriersPlease, Toll, Team Global Express, Hunter Express, and more.

Works with any available tools (Gmail MCP, web scraper, browser automation)
or degrades to providing the correct tracking link from a user-supplied number.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 09:32:43 +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 767bfed9f4 docs: overhaul README with categorised plugin tables and full skill index
Reorganised into Build & Deploy, Design & Frontend, Writing & Documents,
Developer Tools sections. Added collapsible full skill list with trigger
phrases. Updated counts to 10 plugins, 44 skills.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 07:00:49 +11:00
Jez 900d920ecc feat(knowledge-cortex): add Gmail knowledge mining plugin
New plugin with two skills:
- cortex-mine: mine Gmail threads into flat files (~/.cortex/)
- cortex-query: search, stats, client dossier, export

Ships pre-built Python scripts (justified: Gmail API parsing, base64
decoding, JSONL logic). No external dependencies beyond gws CLI and
anthropic SDK. Designed for anyone — no Jezweb-specific integrations.

Performance fix: replaced is_processed() O(n*m) full-file reads with
load_processed_ids() set loaded once at startup.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-13 23:47:50 +11:00
Jeremy Dawes 1e0feabf64 refactor: restructure skill portfolio (36 → 33)
Remove 5 skills that don't earn context cost:
- claude-capabilities, gemini-guide (Claude knows these from training)
- web-design-methodology, web-design-patterns (well-known patterns)
- gemini-image-gen (rules files cover API; dedicated project planned)

Add 2 skills:
- cloudflare/d1-migration: full migration workflow, Drizzle gotchas, stuck migration fix
- dev-tools/git-workflow: PR prep, branch cleanup, conflict resolution, monorepo tags

web-design plugin now single-skill (seo-local-business only).
D1 rules file slimmed — migration workflow absorbed into d1-migration skill.
All docs updated: CLAUDE.md, README.md, marketplace.json, plugin.json files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-11 21:47:03 +11:00
Jeremy Dawes 0fc77e3a33 docs: add agent-browser to dev-tools listings, fix skill count
README, CLAUDE.md, plugin.json, marketplace.json all missing agent-browser.
Updated skill count from 24 to 36 and plugin count from 7 to 9.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 06:58:18 +11:00
Jeremy Dawes fc5baa683d feat(dev-tools): replace gemini-peer-review with brains-trust
Multi-model consultation skill that queries leading LLMs (Gemini, GPT, Qwen,
DeepSeek, etc.) for second opinions on code, architecture, strategy, prompting.
Uses models.flared.au for runtime model discovery instead of hardcoded IDs.
Supports single opinion, consensus (parallel multi-model), and devil's advocate.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 09:34:41 +11:00
Jeremy Dawes 6bef392988 feat(dev-tools): add team-update skill, enhance ux-audit dogfooding, expand permission presets
Team Update skill:
- Playbook pattern: first run discovers tools + saves config, subsequent runs execute from playbook
- Adapts to any MCP setup (chat, issues, tasks, knowledge) with graceful degradation
- Slash command /team-update with modes: update, check, standup, feedback, plan
- Reference files: playbook format, discovery patterns, message composition, feedback triage

UX Audit enhancements:
- Rewritten Mode 1 as dogfooding workflow with user persona adoption
- Added emotional friction tracking (trust, anxiety, certainty)
- Added flow efficiency metrics (click count, decision points, dead ends)
- Added resilience testing (mid-form nav, back button, refresh, double-click)
- Added "big questions" (would I come back? could I teach someone in 2 minutes?)
- Updated report template with flow score table and resilience results

Permission presets expansion (605 → 1141 lines):
- New presets: Java/JVM, .NET, Elixir, Swift, Static Sites, Hosting Platforms,
  Tunneling, SaaS CLIs, Document Processing, CI, Editors/IDE
- Expanded existing: macOS (+screencapture, osascript, caffeinate), Universal Base
  (+seq, bc, column, ping, perl, yes, whois), JS/TS (+corepack, tsup, swc, nx),
  Python (+pdm, hatch, pre-commit), Database (+pg_dump, turso, pscale),
  Mobile (+flutter, dart, fastlane)
- 138 WebFetch domains organised by category matching Bash presets
- Data-driven additions from scanning 179 project settings files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 08:01:17 +11:00
Jeremy Dawes bce23b5e14 refactor: teach patterns not ship scripts, drop skill-creator
Skills now teach Claude what to do instead of shipping pre-built scripts.
Claude generates scripts adapted to the user's environment (OS, runtime,
installed packages) rather than running rigid pre-built ones.

- Remove skill-creator skill (use Anthropic's official one instead)
- Remove all 17 pre-built scripts across 7 skills
- Add 5 reference files with annotated implementation patterns
- Rewrite 6 SKILL.md files from "run this script" to pattern-based
- Update CLAUDE.md with "teach patterns" philosophy
- Net: -2,631 lines deleted, +109 added

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 22:47:40 +11:00
Jeremy Dawes d91773f655 feat: add gemini-image-gen and image-processing skills (#43, #44)
gemini-image-gen: Generate images via Gemini API — hero backgrounds,
OG images, placeholders, textures, style-matched variants. Includes
prompting guide, preset system, and free/paid model selection.

image-processing: Resize, convert, trim, optimise, thumbnail, and
OG card generation using Pillow. No ImageMagick needed. Supports
the full generate→process→deploy pipeline.

Both use Python scripts with zero external dependencies (Pillow is
pre-installed). Tested end-to-end with real API calls.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 01:05:10 +11:00
Jeremy Dawes 0a10f3da76 feat: add tanstack-start skill — full-stack SSR dashboard on Cloudflare Workers
First "skill as template" experiment: Claude generates every file from scratch
per project instead of cloning a template repo. Encodes TanStack Start v1 +
D1/Drizzle + better-auth + shadcn/ui architecture in SKILL.md + 3 references.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 21:12:53 +11:00
Jeremy Dawes 1fcdd613a9 feat: add responsiveness-check skill for viewport layout testing
Replaces PR #40 with a focused version in plugins/dev-tools/. Tests layout
responsiveness only (not general accessibility), uses single-session resize
instead of per-breakpoint sub-agents, and detects layout transitions between
adjacent viewport widths.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 01:14:14 +11:00
Jeremy Dawes 8090fbb672 feat: add project-kickoff and gemini-guide skills
project-kickoff: Bootstrap new projects with curated permission presets
(cloudflare, vercel, node, python, ops/admin), CLAUDE.md templates, and
.gitignore. Includes tidy_permissions.py to analyse messy settings files
— detects leaked secrets, shell fragments, deprecated MCP refs, and
consolidation opportunities.

gemini-guide: Documentation lookup skill for Gemini API — routes queries
to local cached docs (~/Documents/google-gemini-context/) and provides
correction tables for deprecated SDK patterns. Trial of the "guide agent"
pattern (brings docs to Claude, vs gemini-peer-review which sends code
to Gemini).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 23:25:36 +11:00
Jez 8795d3ac5b feat: add WordPress plugin with content management and Elementor skills
Three skills for managing existing WordPress sites:
- wordpress-setup: WP-CLI over SSH, REST API auth, site config
- wordpress-content: Posts, pages, media, categories, menus via WP-CLI
- wordpress-elementor: Elementor page editing via browser automation
  and safe text replacement via WP-CLI search-replace

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 16:28:14 +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
Jez 956e4c3ef9 feat: rename memory-manager → context-manager, add full markdown landscape audit
Expands the audit from 3 layers (CLAUDE.md, rules, auto-memory) to 4+:
- Memory layer: CLAUDE.md + .claude/rules/ (scored, managed)
- Project docs: ARCHITECTURE.md, docs/**/*.md (staleness + overlap detection)
- Session files: SESSION.md, PROJECT_BRIEF.md (presence reporting)
- Public markdown: README.md, CONTRIBUTING.md (CLAUDE.md duplication check)

New features: markdown footprint by layer (total KB), section-level overlap
detection between CLAUDE.md and other docs, expanded JSON output.

Tested on l2chat-widget (279KB, 65 files, 49 overlaps) and mcp-packages
(65 CLAUDE.md files across the monorepo).

v11.0.0. Skill count unchanged at 24.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 10:30:24 +11:00
Jez 721ace616c feat: add ux-audit skill — UX walkthroughs and QA sweeps via browser automation
Three modes: UX walkthrough (walk through app as first-time user, flag friction),
QA sweep (page-by-page CRUD and rendering checks), and targeted checks. Supports
Chrome MCP (authenticated apps with user session) and Playwright. Produces ranked
audit reports with severity levels.

24 skills total, v10.0.0. New "testing" marketplace bundle.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 19:38:48 +11:00
Jez 490a7f0d74 feat: add dev-session skill — multi-session progress tracking and handoff
New skill: dev-session (23rd skill)
- SESSION.md creation and management for multi-session work
- WIP checkpoint commits at milestones
- Session resume with git diff since last checkpoint
- Context compaction survival guide

Updated marketplace to v9.0.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 19:24:25 +11:00
Jez 8e86ae4aa9 docs: add instructions for using v1 deprecated skills
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 19:06:17 +11:00
Jez f71ec2d0b5 feat: add 5 skills — d1-drizzle-schema, hono-api-scaffolder, shadcn-ui, github-release, gemini-peer-review
New workflow skills:
- d1-drizzle-schema: Drizzle ORM schema generation for Cloudflare D1
- hono-api-scaffolder: Hono API routes, middleware, endpoint docs
- shadcn-ui: Component installation, customisation, recipes
- github-release: Sanitize repos and publish tagged GitHub releases
- gemini-peer-review: Second opinion from Gemini via gemini-coach CLI

Updated marketplace to v8.0.0 (22 skills), added v1→v2 history to README.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-18 19:03:50 +11:00
Jez fb9e96debc feat: add claude-capabilities and aussie-business-english skills (17 total)
claude-capabilities: Current Claude AI & Code features reference with
4 on-demand reference files (claude-ai, claude-code, models, changelog).
Covers Agent Teams, Interactive Apps, Cowork, and other post-training features.

aussie-business-english: Australian business English writing style guide
with EN-AU spelling, tone ladder, corporate-ism replacements, and
before/after examples.

Both are dual-environment (Claude AI + Claude Code). New "writing"
marketplace bundle added. Development bundle updated.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-17 11:51:36 +11:00
Jez 3140d0a042 feat: add google-apps-script skill (15th skill)
Restructured from Claude AI draft (754 lines) into workflow skill:
- SKILL.md (307 lines): workflow, critical rules, modal progress dialog
- references/patterns.md: menus, sidebar, triggers, email, PDF export
- references/recipes.md: archive, duplicates, auto-number, dashboard
- references/quotas.md: limits table, debugging, deployment checklist

Added to "integrations" marketplace bundle alongside google-chat-messages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 21:02:37 +11:00
Jez 3886db9dee feat: add 5 new skills — SEO, web design, Google Chat, vite-flare-starter
New skills (9 → 14 total):
- seo-local-business: JSON-LD, meta tags, sitemap for local businesses
- web-design-methodology: BEM, responsive, a11y, dark mode patterns
- web-design-patterns: heroes, cards, CTAs, trust signals, testimonials
- google-chat-messages: webhook text, cardsV2, threading
- vite-flare-starter: clone+configure full-stack Cloudflare starter

Updated marketplace.json (v5.0.0) with "web" and "integrations" bundles.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 12:14:48 +11:00
Jez d0cd7a6e95 fix: align plugin system with Anthropic's marketplace pattern
- marketplace.json: use skills[] arrays in plugin entries (matches Anthropic format)
- Add per-skill .claude-plugin/plugin.json for standalone installability
- Group skills into bundles: all, design, cloudflare, frontend, ai, mcp, development
- Update install docs in README.md and CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 10:26:08 +11:00
Jez c7c9090093 fix: audit fixes — remove claude.ai paths, update spec URL, add memory-manager to docs
- icon-set-generator: replace /mnt/user-data/ and /home/claude/ with relative paths
- CLAUDE.md: add memory-manager to directory listing, update spec URL to agentskills.io
- README.md: update spec link

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 10:00:26 +11:00
Jez e60cb4e451 feat: v2 — strip to 9 workflow/recipe skills
Drop 96 knowledge-dump skills, gut infrastructure, rebuild survivors
as recipe-style SKILL.md files under 500 lines. Adopt Anthropic's
official skill-creator. Add memory-manager and icon-set-generator.

CLAUDE.md: 2,100 → 85 lines. Total SKILL.md: 3,892 → 1,577 lines.
Full history preserved in v1-final tag.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 09:50:18 +11:00
Jez abde401793 docs: Add plugin architecture guide and update installation instructions
- Create PLUGIN_ARCHITECTURE.md explaining marketplace vs installation
- Update README with proper two-step install flow
- Document why skill-bundled commands/agents need individual installs
- List skills with commands/agents that should be installed separately

Key insight: Marketplace is just a catalog. Users must explicitly install
each plugin they want. Bundle installs (all@) don't discover nested
commands/agents in skills/*/commands/ paths.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 11:13:33 +11:00
Jez 1152752c31 refactor: Consolidate commands into skills architecture
- Create skill-development skill with /create-skill, /review-skill, /audit commands
- Move templates/ into skills/skill-development/templates/
- Move /context-mate command into skills/context-mate/commands/
- Delete orphan /commands/ and /templates/ directories
- Update plan-project.md in project-workflow with session protocol content
- Add user-invocable: true to context-mate skill

This follows official Claude Code recommendation: slash commands should be
bundled with skills, not as separate orphan files. Forkers now get full
skill development tooling when they install skill-development.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 19:29:20 +11:00
Jez 4a562a7ffa docs: Add decision tree, terminology, fix /brief & /reflect descriptions
README.md:
- Add "Where to Start" decision tree (5 common scenarios)
- Add "Terminology" section explaining skill vs command vs agent

context-mate SKILL.md & command:
- Add missing /brief command to Quick Reference
- Fix /reflect description (captures learnings → rules, not just "review")
- Fix /brief description (preserves context, not "quick summary")

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 17:14:04 +11:00
Jez c2aad22843 docs: Add /context-mate to README with screenshot
- Update Context Mate section to mention /context-mate command
- Add screenshot showing project analysis output
- Link to full guide in skills/context-mate/SKILL.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 15:55:41 +11:00
Jez df9170ff29 style: Add knifey-spooney personality to Context Mate
The laid-back Aussie approach to project management:
- "She'll be right" > "Follow the methodology"
- Homer Simpson accessibility standard
- No ceremonies, no standups with your AI

If you can't figure it out in 30 seconds, it's too complicated.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 15:11:13 +11:00
Jez 1c35348a17 feat(skills): Add context-mate toolkit entry point with dynamic analysis
Context Mate is the entry point to the project lifecycle toolkit:
- Explains how skills, agents, and commands fit together
- Dynamic project analysis: scans for SESSION.md, phases, git state
- Recommends tools based on project stage (new, active, maintenance)
- Documents core concepts: sessions vs phases, checkpointed progress

"It's all about the context, maaate!"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 14:42:43 +11:00
Jez 02130a31ec docs: Add Plugin Installation Guide and Troubleshooting docs
Two high-priority documentation gaps identified in the deep audit:

**docs/PLUGIN_INSTALLATION_GUIDE.md**
- Complete guide to plugin system (marketplace vs local)
- Local testing workflow (install → restart → test → iterate)
- Cache behavior and troubleshooting
- Common installation scenarios

**docs/TROUBLESHOOTING.md**
- Skill discovery issues and fixes
- Installation error solutions
- Template and config troubleshooting
- YAML frontmatter validation
- Self-diagnosis checklist

Also added links to new docs in README.md and CLAUDE.md.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 14:05:12 +11:00
Jez 49b98341b5 docs: Deep audit fixes and auto-generated skills catalog
Documentation audit found 45 issues across consistency, completeness,
accuracy, and freshness. This commit addresses the critical fixes:

**New: Auto-generated SKILLS_CATALOG.md**
- Created scripts/generate-skills-catalog.py to auto-generate catalog
- 96 skills now properly categorized (was manually maintained, drifted to 60)
- 611+ errors prevented across all skills
- Run `python3 scripts/generate-skills-catalog.py` to regenerate

**Fixed: Broken references**
- SKILLS_CATALOG.md link path in README.md
- install-skill.sh references updated to /plugin install (9 places)
- Skill counts updated from 95 to 96 across all docs

**Fixed: Stale dates**
- CLAUDE.md: Last Updated, Last Verified, Current Status
- docs/GEMINI_GUIDE.md: Last Updated (was 2025-11-20)
- docs/MARKETPLACE.md: Last Updated, skill count

**Fixed: Directory documentation**
- archive/: Added audit-cache/, clarified low-priority-skills branch
- templates/: Added 3 missing template files
- docs/: Added QA_AGENTS_GUIDE.md, JEZWEB_WORKFLOW.md

**Added: Audit report**
- planning/DOC_AUDIT_2026-02-02.md with full findings

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 13:58:28 +11:00
Jeremy Dawes 507d8fefa2 feat: Rename marketplace from claude-skills to jezweb-skills (issue #13)
BREAKING CHANGE: Marketplace name changed from `claude-skills` to `jezweb-skills`

Migration for existing users:
```bash
/plugin marketplace remove claude-skills
/plugin marketplace add jezweb/claude-skills
```

Why:
- Avoids namespace collision with other marketplaces using generic name
- Anthropic prefers third-parties don't use "Claude" in names
- jezweb-skills is unique and properly attributed

Files updated:
- .claude-plugin/marketplace.json - primary identifier
- All documentation with @claude-skills references
- Scripts with install examples

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 15:38:21 +11:00
Jez 0d99e13e16 feat(skills): Add project-health skill for AI-agent readiness auditing
New skill bundle for evaluating project health from an AI-agent perspective:

Agents:
- context-auditor: AI-readability checks (explicit paths, actionable instructions)
- workflow-validator: Process executability (discrete steps, verification)
- handoff-checker: Session continuity (SESSION.md, context preservation)

Templates:
- AI_READABLE_DOC.md: Template for agent-optimized documentation
- HANDOFF_CHECKLIST.md: Session handoff verification

Also:
- README.md: Added MIT/stars/PRs badges
- GitHub topics added: claude-code, skills, cloudflare, ai, anthropic
- Draft Anthropic registry submission prepared

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 14:21:26 +11:00
Jeremy Dawes e6cdd081d5 docs(agents): Remove skill-auditor, add QA Agents Guide
- Remove skill-auditor.md (superseded by specialized QA agents)
- Add expanded documentation sources table to content-accuracy-auditor
- Update references in CLAUDE.md, README.md, web-researcher.md
- Create docs/QA_AGENTS_GUIDE.md with:
  - Quick reference table for all QA agents
  - Confidence ratings explanation
  - Common workflows (quarterly audit, after package update, quick check)
  - Orchestrated vs on-demand usage patterns
  - Cross-agent coordination examples
  - Troubleshooting guide

The new QA agent squad (content-accuracy-auditor, code-example-validator,
api-method-checker, version-checker) replaces the monolithic skill-auditor
with specialized, dimension-specific agents that work better in parallel.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 20:43:47 +10:00
Jeremy Dawes 54189b5474 docs: Update skill counts and add developer-toolbox references
- CLAUDE.md: Update skill count to 87, last updated date
- README.md: Update skill count to 87, add Developer Workflow category

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-20 00:56:19 +10:00