mirror of
https://github.com/katanemo/plano.git
synced 2026-04-27 17:56:28 +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>
33 lines
967 B
Markdown
33 lines
967 B
Markdown
---
|
|
name: plano-observability-debugging
|
|
description: Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.
|
|
license: Apache-2.0
|
|
metadata:
|
|
author: katanemo
|
|
version: "1.0.0"
|
|
---
|
|
|
|
# Plano Observability and Debugging
|
|
|
|
Use this skill to make routing and latency behavior inspectable and debuggable.
|
|
|
|
## When To Use
|
|
|
|
- "Enable tracing correctly"
|
|
- "Add useful span attributes"
|
|
- "Debug why a request routed incorrectly"
|
|
- "Inspect filter/model latency from traces"
|
|
|
|
## Apply These Rules
|
|
|
|
- `observe-tracing`
|
|
- `observe-span-attributes`
|
|
- `observe-trace-query`
|
|
|
|
## Execution Checklist
|
|
|
|
1. Enable tracing with environment-appropriate sampling.
|
|
2. Add useful static and header-derived span attributes.
|
|
3. Use `planoai trace` filters to isolate route and latency issues.
|
|
4. Prefer trace evidence over assumptions in recommendations.
|
|
5. Return exact commands to reproduce and validate findings.
|