Example Agents

Coding

Development agents

coder.md

Full coding assistant with planner sub-agent and GitHub MCP. Reads code, makes changes, runs tests.

Claude SonnetshellgitMCPdelegate

go-dev.md

Go developer — idiomatic Go, concurrency patterns, testing, performance optimization.

Gogofmtstaticcheck

python-dev.md

Python developer — Django, FastAPI, Flask, async programming, packaging with pyproject.toml.

Pythonruffpytest

qwen-coder.md

Local coding assistant on Ollama. No API key, no cost. Good for offline work.

Ollamafreelocal

reviewer.md

Code review — read-only, never edits. Finds bugs, security issues, style problems.

read-onlyfs_readfs_list

writer.md

Documentation and prose. READMEs, guides, comments. Reads existing docs for context.

Claude Sonnetfs_readfs_write

planner.md

Task planning — breaks work into numbered checklists. No execution, plans only.

Claude Haikuread-only

summarize.md

Project summarizer. Explores a directory and produces a 5–10 bullet summary.

Claude Sonnetshellfs_read

DevOps

Infrastructure agents

devops.md

General DevOps — Dockerfiles, CI/CD, shell scripts, infra config. Explores before editing.

Claude Sonnetshellfs_write

ansible.md

Ansible automation — playbooks, roles, inventory, best practices. FQCNs, ansible-lint, vault.

Ansibleansible-lintvault

k8s-debug.md

Kubernetes troubleshooter. Systematic triage: events → describe → logs → root cause → fix.

kubectlshellgit

terraform-plan.md

Terraform plan review. Catches security issues, unexpected destroys, missing tags.

terraformshellfs_write

helm-deploy.md

Helm chart management. Lints, renders templates, reviews values for production readiness.

helmshellfs_write

security.md

Security engineer — code review, secrets detection, container hardening, CVE analysis.

securitytrivygitleaks

Database

Database agents

dba.md

Database administrator — PostgreSQL, MySQL, migrations, performance tuning, backup strategies.

PostgreSQLMySQLmigrations

Ticket-driven

Jira & Confluence agents

ticket-worker.md

Reads Jira ticket → explores codebase → creates branch → implements → tests → commits → updates ticket.

Jira MCPConfluencegittest_run

ticket-reviewer.md

Reviews code against ticket acceptance criteria. Posts findings back to Jira. Read-only.

Jira MCPgitread-only

Orchestration

Hub-and-spoke agents

orchestrator.md

Routes tasks to the right specialist automatically — coder, reviewer, writer, devops, planner, summarize.

delegate6 sub-agents

hub.md

Structured hub — delegates to spoke agents that return JSON with citations and confidence levels.

structured outputdelegate

spoke-coder.md

Spoke agent — writes code, returns structured JSON with sources, confidence, and caveats.

response_schemafs_write

spoke-reviewer.md

Spoke agent — reviews code, returns structured JSON. Read-only, terse, one issue per bullet.

response_schemaread-only

spoke-planner.md

Spoke agent — creates implementation plans as structured JSON. 3–10 concrete steps.

response_schemaread-only

Personality

Character agents

steva-djubre.md

Steva Đubre — grumpy Serbian DevOps SRE with 25+ years experience. Responds exclusively in Serbian. Worst attitude, best results.

SerbianClaude Sonnetall tools

steve-trash.md

Steve Trash — English version. Same terrible attitude, same incredible skills. Mocks your code while fixing it.

EnglishDeepSeekall tools

steva-djubre-max.md

Steva on Qwen Max — premium Alibaba model variant for best quality Serbian responses.

Alibabaqwen-max

steva-djubre-flash.md

Steva on Qwen Flash — fast and cheap variant. Same character, lower cost.

Alibabaqwen-flash

Advanced

Agent Features

Code Search (RAG)

Search the codebase without reading every file. Two modes:

text — grep/ripgrep for exact pattern matching across all source files
symbol — in-memory index of functions, types, classes, imports. Built automatically on first use.

Languages indexed: Go, Python, JavaScript, TypeScript, Java, Ruby, Rust, Terraform, Shell.

tools:
  - code_search

Fallback Models

When the primary model returns 429 (rate limit), the agent automatically tries the next model in the list.

fallback:
  - anthropic/claude-haiku-4-5-20251001
  - openai/gpt-4.1

Thinking Phrases

Customize the spinner text shown while the agent works. Useful for non-English agents.

thinking_phrases:
  - "razmišljam"
  - "čekaj bre"
  - "tražim bug"

PII Guardrails

Protect sensitive data from being sent to LLM providers. Scans for emails, phone numbers, SSNs, credit cards, IP addresses, API keys, JWTs, and passwords.

pii_guard: redact   # redact | warn | off

Modes:

redact — replaces PII with placeholders (<EMAIL>, <PHONE>, etc.) before sending
warn — shows what was detected, sends anyway
off — no scanning (default)

Toggle in session: /pii (on) / /pii off

Mermaid Diagrams

Add the mermaid-diagrams skill to teach your agent to produce architecture diagrams, flowcharts, and sequence diagrams.

skills:
  - mermaid-diagrams