What problem does it solve?
Agent-facing skill files for Phoenix (phoenix-tracing, phoenix-cli, phoenix-evals) drift out of sync with the actual Python clients, TypeScript clients, CLI, and REST/GraphQL APIs as new code ships, teaching every future agent the wrong API. This Skill audits recent commits on origin/main and applies corrective edits directly to the skill files.
Core Features & Use Cases
- Commit triage: Fetches commits from origin/main over a configurable window (default 7 days) and classifies them into audit candidates, skips, and unclear items requiring diff inspection.
- Source-to-skill mapping: Maps changes in phoenix-otel, phoenix-evals, phoenix-client, phoenix-cli, and server APIs to the correct target skill by exposed feature, including Python/TypeScript mirror checks.
- In-place patching: Edits SKILL.md files and references/*.md files with verified signatures, runnable examples, and updated cross-links, then emits a structured run summary for PR bodies.
- Use Case: After a week of merges adding a new CLI subcommand and a new evaluator class, run the audit to update phoenix-cli/SKILL.md and phoenix-evals/references/evaluators-pre-built.md with verbatim signatures and verified examples.
Quick Start
Ask the agent to audit the phoenix-tracing, phoenix-cli, and phoenix-evals skills against the last 7 days of changes on origin/main and patch anything stale in place.