debug Skill
Investigate stuck runs and execution failures by tracing Symphony and Codex logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly. Published by openai in symphony.
What is debug Skill?
Investigate stuck runs and execution failures by tracing Symphony and Codex logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly. Published by openai in symphony. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.
Automated repository signals based on public metadata such as recency, license, installation evidence, and adoption. These are not a security audit or endorsement.
Key capabilities
- Includes SKILL.md support
- Reusable instructions support
- Documentation
- Documentation use cases
Technical details
- Install or run with Copy skill directory
When to use debug Skill
- Use it for documentation.
Built with
Editorial notes
Source
- Creator: openai
- Repository: openai/symphony
- Skill file: .codex/skills/debug/SKILL.md
What it does
Investigate stuck runs and execution failures by tracing Symphony and Codex logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly.
Skill instructions
Debug Goals - Find why a run is stuck, retrying, or failing. - Correlate Linear issue identity to a Codex session quickly. - Read the right logs in the right order to isolate root cause. Log Sources - Primary runtime log: log/symphony.log - Default comes from SymphonyElixir.LogFile (log/symphony.log). - Includes orchestrator, agent runner, and Codex app-server lifecycle logs. - Rotated runtime logs: log/symphony.log - Check these when the relevant run is older. Correlation Keys - issueidentifier: human ticket key (example: MT-625) - issueid: Linear UUID (stable internal ID) - sessionid: Codex thread-turn pair (<threadid-<turnid) elixir/docs/logging.md requires these fields for issue/session lifecycle logs. Use them as your join keys during debugging. Quick Triage (Stuck Run) 1. Confirm scheduler/worker symptoms for the ticket. 2. Find recent lines for the ticket (issueidentifier first). 3. Extract sessionid from matching lines. 4. Trace that sessionid across start, stream, completion/f
Explore related resources
Frequently asked questions
What is debug?
debug is a open-source AI agent skill with Copy skill directory. Investigate stuck runs and execution failures by tracing Symphony and Codex logs with issue/session identifiers; use when runs stall, retry repeatedly, or fail unexpectedly.
Who is debug best for?
debug is best for reusing agent instructions, scripts, and references, documentation workflows.
How do I install debug?
Install or run debug using Copy skill directory. Check debug for the latest setup command.
Is debug actively maintained?
debug may need a closer maintenance check before production use.
Auto-fetched from GitHub.
