recipes

Files (14)

• SKILL.md
• agent-skills.md · references/
• agentic-cli.md · references/
• beads-dolt-setup.md · references/
• claude-plugin-authoring.md · references/
• claude-tools.md · references/
• cli-location-discovery.md · references/
• comments.md · references/
• extract-deterministic.md · references/
• keyring-credential-storage.md · references/
• python-project-architecture.md · references/
• semantic-zoom.md · references/
• showboat-ecosystem.md · references/
• snapshot-testing.md · references/

SKILL.md (first lines)

<essential_principles>

## What Recipes Are

Recipes are **standalone reference documents** -- each captures a proven pattern or practice for AI-assisted development. They are not step-by-step procedures; they are knowledge you read and apply.

**Three categories:**

| Category | Recipes | When to Use |
|----------|---------|-------------|
| **AI Agent Patterns** | semantic-zoom, agentic-cli, extract-deterministic, showboat-ecosystem | Designing AI interactions, CLI tools for agents, or agent-driven documentation |
| **Development Practices** | comments, agent-skills, claude-tools, snapshot-testing | Writing code, skills, or tests in this ecosystem |
| **Distribution** | claude-plugin-authoring | Packaging skills as installable Claude Code plugins |
| **Architecture & Implementation** | python-project-architecture, keyring-credential-storage, cli-location-discovery | Structuring Python projects, handling credentials, or CLI location/config discovery |
| **Infrastructure & Setup** | beads-dolt-setup | Setting up beads issue tracker with Dolt server on macOS |

</essential_principles>

<intake>
What pattern or practice do you need guidance on?

1. **AI agent CLI design** - Safe-by-default CLI patterns for agentic workflows
2. **Extracting deterministic work** - When to script vs. when to prompt
3. **Semantic zoom** - Controlling abstraction level in AI interactions
4. **Python commenting standards** - INTENT:, CRITICAL:, PERF: anchors
5. **Writing Claude Code skills** - Skill authoring patterns and best practices
6. **Claude Code tools reference** - All 20 native tools, coordination patterns, agent spawning
7. **Snapshot testing** - Approval testing with syrupy
8. **Python project architecture** - Project structure for CLI tools
9. **Keyring credential storage** - Secure credential management patterns
10. **Claude plugin authoring** - Packaging skills as installable plugins
11. **CLI location & config discovery** - Finding scripts and config from arbitrary cwd
12. **Beads + Dolt setup** - Installing and configuring beads with Dolt server on macOS
13. **Showboat ecosystem** - Agent-driven documentation with Showboat, Rodney, and Chartroom

**Wait for response before proceeding.**
</intake>

<routing>

| Response | Reference |
|----------|-----------|
| 1, "cli", "agentic", "safe", "flags", "non-interactive" | `references/agentic-cli.md` |
| 2, "deterministic", "extract", "script vs prompt" | `references/extract-deterministic.md` |
| 3, "zoom", "abstraction", "detail level", "semantic" | `references/semantic-zoom.md` |
| 4, "comment", "intent", "critical", "perf", "anchor" | `references/comments.md` |
| 5, "skill", "writing", "skill.md", "author" | `references/agent-skills.md` |
| 6, "tools", "task tool", "claude tools", "subagent", "task management" | `references/claude-tools.md` |
| 7, "snapshot", "testing", "syrupy", "approval" | `references/snapshot-testing.md` |
| 8, "architecture", "python project", "cli tool", "structure" | `references/python-project-architecture.md` |
| 9, "keyring", "credential", "password", "secret" | `references/keyring-credential-storage.md` |
| 10, "plugin", "marketplace", "distribute", "package", "install" | `references/claude-plugin-authoring.md` |
| 11, "location", "discovery", "vault", "find_vault", "cwd", "wrong directory", "config init", "bootstrap" | `references/cli-location-discovery.md` |
| 12, "beads", "dolt", "bd init", "dolt server", "issue tracker setup" | `references/beads-dolt-setup.md` |
| 13, "showboat", "rodney", "chartroom", "demo", "living docs", "agent documentation" | `references/showboat-ecosystem.md` |
| Other | Clarify intent, then select appropriate reference |

**After identifying the reference, read it and apply its guidance to the user's situation.**

</routing>

<reference_index>

## AI Agent Patterns

- [agentic-cli.md](references/agentic-cli.md) - CLI design patterns for AI agents (non-interactive, capability gradient, dry-run)
- [extract-deterministic.md](references/extract-deterministic.md) - When to extract deterministic work from AI workflows into scripts
- [semantic-zoom.md](references/semantic-zoom.md) - Controlling abstraction level in AI interactions
- [showboat-ecosystem.md](references/showboat-ecosystem.md) - Agent-driven documentation with Showboat, Rodney, and Chartroom

## Development Practices

- [comments.md](references/comments.md) - Python commenting standards with INTENT:, CRITICAL:, PERF: anchors
- [agent-skills.md](references/agent-skills.md) - Patterns for writing effective Claude Code skills
- [claude-tools.md](references/claude-tools.md) - Complete Claude Code tools reference (all 20 native tools)
- [snapshot-testing.md](references/snapshot-testing.md) - Approval testing with syrupy framework

## Distribution

- [claude-plugin-authoring.md](references/claude-plugin-authoring.md) - Packaging skills as installable Claude Code plugins

## Architecture & Implementation

- [python-project-architecture.md](references/python-project-architecture.md) - Python project architecture for CLI tools
- [keyring-credential-storage.md](references/keyring-credential-storage.md) - Keyring credential storage pattern
- [cli-location-discovery.md](references/cli-location-discovery.md) - CLI location & config discovery for skill-bundled scripts

## Infrastructure & Setup

- [beads-dolt-setup.md](references/beads-dolt-setup.md) - Beads + Dolt server setup on macOS (install, init, migration, maintenance)

</reference_index>

<success_criteria>

- User gets directed to the right reference for their question
- Reference content is applied to the user's specific situation, not just recited
- Multiple references can be combined when a question spans categories

</success_criteria>

From durandom/skills, GPL-3.0.

More from durandom/skills