Recipes

Skill durandom/skills/skills/dev-tools/recipes

Reusable development patterns and guides for AI-assisted workflows. Use when asking about CLI design for agents, CLI location, config discovery, vault, commenting standards, snapshot testing, credential storage, Python project architecture, semantic zoom, skill writing, Claude tools, agent teams, extracting deterministic work, plugin authoring and distribution, beads/dolt setup, or showboat/rodney/chartroom agent documentation.From its SKILL.md

Install

npx -y skills add durandom/skills --skill recipes

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

6.1 KB, as published. Nobody here has run it

<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?

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

Wait for response before proceeding. </intake>

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 - CLI design patterns for AI agents (non-interactive, capability gradient, dry-run)
extract-deterministic.md - When to extract deterministic work from AI workflows into scripts
semantic-zoom.md - Controlling abstraction level in AI interactions
showboat-ecosystem.md - Agent-driven documentation with Showboat, Rodney, and Chartroom

Development Practices

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

Distribution

claude-plugin-authoring.md - Packaging skills as installable Claude Code plugins

Architecture & Implementation

python-project-architecture.md - Python project architecture for CLI tools
keyring-credential-storage.md - Keyring credential storage pattern
cli-location-discovery.md - CLI location & config discovery for skill-bundled scripts

Infrastructure & Setup

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>