mirror of
https://github.com/katanemo/plano.git
synced 2026-04-24 16:26:34 +02:00
743d074184
Some checks are pending
CI / pre-commit (push) Waiting to run
CI / plano-tools-tests (push) Waiting to run
CI / native-smoke-test (push) Waiting to run
CI / docker-build (push) Waiting to run
CI / validate-config (push) Waiting to run
CI / security-scan (push) Blocked by required conditions
CI / test-prompt-gateway (push) Blocked by required conditions
CI / test-model-alias-routing (push) Blocked by required conditions
CI / test-responses-api-with-state (push) Blocked by required conditions
CI / e2e-plano-tests (3.10) (push) Blocked by required conditions
CI / e2e-plano-tests (3.11) (push) Blocked by required conditions
CI / e2e-plano-tests (3.12) (push) Blocked by required conditions
CI / e2e-plano-tests (3.13) (push) Blocked by required conditions
CI / e2e-plano-tests (3.14) (push) Blocked by required conditions
CI / e2e-demo-preference (push) Blocked by required conditions
CI / e2e-demo-currency (push) Blocked by required conditions
Publish docker image (latest) / build-arm64 (push) Waiting to run
Publish docker image (latest) / build-amd64 (push) Waiting to run
Publish docker image (latest) / create-manifest (push) Blocked by required conditions
Build and Deploy Documentation / build (push) Waiting to run
* feat: add initial documentation for Plano Agent Skills * feat: readme with examples * feat: add detailed skills documentation and examples for Plano --------- Co-authored-by: Adil Hafeez <adil.hafeez@gmail.com>
2.1 KiB
2.1 KiB
| name | description | license | metadata | ||||
|---|---|---|---|---|---|---|---|
| plano-agent-skills | Best practices for building agents and agentic applications with Plano, including configuration, routing, orchestration, guardrails, observability, and deployment. | Apache-2.0 |
|
Plano Agent Skills
Comprehensive Plano guidance for coding agents. Use this umbrella skill when a task spans multiple areas (config, routing, orchestration, filters, observability, CLI, deployment).
When To Use
- Validating or fixing Plano
config.yaml - Designing listener architecture (
model,prompt,agent) - Improving model/provider routing quality and fallback behavior
- Hardening filter chains and prompt guardrails
- Debugging routing with traces and CLI workflows
- Preparing deployment and production readiness checks
How To Use
- Classify the request by scope (single section vs. cross-cutting).
- For focused work, prefer a section-specific skill (for example
plano-routing-model-selection). - For broad work, apply this umbrella skill and reference section rules from
skills/AGENTS.md. - Produce concrete edits first, then concise reasoning and validation steps.
Operating Workflow
- Identify the task area first: config, routing, orchestration, filters, observability, CLI, or deployment.
- Apply the smallest correct change that satisfies the requested behavior.
- Preserve security and reliability defaults:
version: v0.3.0- exactly one
default: truemodel provider - secrets via
$ENV_VARsubstitution only host.docker.internalfor host services from inside Docker- guardrails before enrichment in filter chains
- For debugging, prioritize traces over guesswork (
planoai up --with-tracing,planoai trace). - Return concrete diffs and a short validation checklist.
Response Style
- Prefer actionable edits over generic advice.
- Be explicit about why a config choice is correct.
- Call out risky patterns (hardcoded secrets, missing default provider, bad filter ordering).
- Keep examples minimal and production-viable.
References
- Repo: https://github.com/katanemo/plano
- Full rulebook:
skills/AGENTS.md