skill-review
Skill Review & Gardening
Automated and manual processes for keeping the 51+ joelclaw skills accurate and healthy. ADR-0179.
Canonical Contract
- Source of truth:
~/Code/joelhooks/joelclaw/skills/(repo, fully git-tracked) - Home dir consumers (symlink IN to repo):
~/.agents/skills/<name>→~/Code/joelhooks/joelclaw/skills/<name>~/.pi/agent/skills/<name>→~/Code/joelhooks/joelclaw/skills/<name>
- Never put skill content in dot directories (
.agents/,.pi/,.claude/). Those are symlink consumers. - Third-party skill packs (axiom-*, marketing, etc.) live in
~/.agents/skills/as external installs — NOT in the repo.
Automated Garden (Inngest)
The skill-garden function runs daily at 6am PT and checks:
Daily (structural + patterns)
More from joelhooks/joelclaw
cli-design
Design and build agent-first CLIs with HATEOAS JSON responses, context-protecting output, and self-documenting command trees. Use when creating new CLI tools, adding commands to existing CLIs (joelclaw, slog), or reviewing CLI design for agent-friendliness. Triggers on 'build a CLI', 'add a command', 'CLI design', 'agent-friendly output', or any task involving command-line tool creation.
131k8s
>-
88docker-sandbox
Create, manage, and execute agent tools (claude, codex) inside Docker sandboxes for isolated code execution. Use when running agent loops, spawning tool subprocesses, or any task requiring process isolation. Triggers on "sandbox", "isolated execution", "docker sandbox", "safe agent execution", or when working on agent loop infrastructure.
86joel-writing-style
Joel's writing voice and style guide for joelclaw.com content. Use when writing, editing, or reviewing any blog post, essay, book chapter, or prose content for joelclaw.com. Also use when asked to 'write like Joel,' 'match Joel's voice,' 'draft a post,' 'write content for the blog,' or 'review this for voice.' This skill captures Joel's specific writing patterns derived from ~90,000 words of published content spanning 2012–2026. Cross-reference with copy-editing and copywriting skills for marketing-specific copy.
81contacts
Add, enrich, and manage contacts in Joel's Vault. Fire the Inngest enrichment pipeline for full multi-source dossiers, or create quick contacts manually. Use when: 'add a contact', 'enrich this person', 'who is X', 'VIP contact', 'update contact', or any task involving the Vault/Contacts directory.
64task-management
Manage Joel's task system in Todoist. Triggers on: 'add a task', 'create a todo', 'what's on my list', 'today's tasks', 'what do I need to do', 'remind me to', 'inbox', 'complete', 'mark done', 'weekly review', 'groom tasks', 'what's next', or when actionable items emerge from other work. Also triggers when Joel mentions something he needs to do in passing — capture it.
54