# Add Example Agent

Adds a self-contained example agent under the examples folder for a pattern.

- Repository: https://github.com/GetBindu/Bindu (10015 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-09-06
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add GetBindu/Bindu --skill add-example-agent -g -a claude-code -y`
Codex: `npx skills add GetBindu/Bindu --skill add-example-agent -g -a codex -y`
Cursor: `npx skills add GetBindu/Bindu --skill add-example-agent -g -a cursor -y`
Gemini CLI: `npx skills add GetBindu/Bindu --skill add-example-agent -g -a gemini-cli -y`

## Description

Add a new self-contained example agent under examples/. Use when asked to "create an example for <framework>", "add a tutorial agent", "demo integration with <LLM provider>", or when showcasing a new pattern users should copy.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Add Example Agent

## Overview

Examples under [examples/](../../../examples/) are the fastest way users learn Bindu. Each is a self-contained mini-project demonstrating one integration pattern. Follow existing structure, users and agents discover examples by convention, so inconsistency hurts discoverability.

## Inputs

- `<name>`: kebab-case slug, e.g. `pdf-research-agent`, `weather-research`.
- `<framework>`: Python (agno, langchain, langgraph, crewai) or TypeScript (openai, langchain).
- `<purpose>`: one-sentence "what this demonstrates".

## Safety

- Never commit `.env` files. Only `.env.example` with placeholder values and `# pragma: allowlist secret` to bypass pre-commit.
- Never hardcode API keys, even in comments.
- Never introduce paid-only services without a free-tier alternative. Examples must be runnable by a new user within minutes.
- Never hardcode ports, default to `3773` with `BINDU_PORT` override.

## Execution Contract

1. Pick a matching template from existing examples.
2. Create the directory with the required file set.
3. Wire the handler to `bindufy()` with consistent config.
4. Write a README following the four-section pattern below.
5. Update parent indexes.
6. Test end-to-end in a clean environment before committing.

## Steps

### 1. Pick a template

Find an existing example in the same framework and match its layout:

- Python, simple: [examples/beginner/](../../../examples/beginner/)
- Python, multi-agent: [examples/agent_swarm/](../../../examples/agent_swarm/)
- Python, agno: [examples/medical_agent/](../../../examples/medical_agent/)
- Python, langgraph: [examples/langgraph_blog_writing_agent/](../../../examples/langgraph_blog_writing_agent/)
- TypeScript, openai: [examples/typescript-openai-agent/](../../../examples/typescript-openai-agent/)
- TypeScript, langchain: [examples/typescript-langchain-agent/](../../../examples/typescript-langchain-agent/)

### 2. Create the directory

The rest: https://github.com/GetBindu/Bindu/blob/HEAD/.agents/skills/add-example-agent/SKILL.md