Botanu SDK Skills

AI coding tool skills that help you instrument your code with Botanu SDKs. Drop these into your project and your AI assistant (Claude Code, Cursor, Windsurf, GitHub Copilot) will know how to add Botanu observability to your codebase.

What's included

Skill	Description
setup	Install SDK, configure environment, initialize tracing
instrument-workflow	Add workflow decorators to business functions
add-outcomes	Track success/failure with emit_outcome
track-llm	Manual LLM call tracking (when auto-instrumentation doesn't cover it)
track-data	Manual database/storage/messaging tracking
add-middleware	Web framework middleware (Express, FastAPI, etc.)
verify	Verify instrumentation is working
full-onboarding	Complete end-to-end setup (runs all above)

Supports Python (botanu) and TypeScript (@botanu/sdk). Java SDK coming soon.

Installation

Copy the files for your AI coding tool into your project root:

Claude Code

cp -r dist/claude-code/.claude .claude/
cp dist/claude-code/CLAUDE.md .

Then use slash commands like /botanu-setup, /botanu-instrument-workflow, or /botanu-full-onboarding.

Cursor

cp -r dist/cursor/.cursor .cursor/
cp dist/cursor/.cursorrules .

Rules are available as individual .mdc files in .cursor/rules/ and as a combined .cursorrules file.

Windsurf

cp dist/windsurf/.windsurfrules .

GitHub Copilot

cp -r dist/github-copilot/.github .github/

Instructions are in .github/copilot-instructions.md (shared context) and .github/instructions/ (individual skills).

Building from source

If you modify the skill content in src/, rebuild the dist/ output:

npm run build

This reads src/_shared/ (reference material) and src/skills/ (skill definitions), then generates tool-specific output in dist/ for all four AI tools.

Structure

src/
  _shared/          # Reference material (API docs, concepts, env vars)
  skills/           # Skill definitions (YAML frontmatter + markdown instructions)
scripts/
  build.mjs         # Build script (zero dependencies)
  templates/        # Per-tool output formatters
dist/               # Generated output (committed, ready to copy)
  claude-code/
  cursor/
  windsurf/
  github-copilot/

Adding a new skill

1. Create src/skills/your-skill.md with YAML frontmatter:

   ---
   id: your-skill
   title: Your Skill Title
   description: One-line description
   order: 10
   ---
   
   Instructions for the AI assistant...

2. Run npm run build

3. The skill appears in all four tool outputs automatically