Skip to content
cccskills
FreePublished on GitHub

trace-qa

Investigate an agent run by reviewing its execution trace, a record of steps and tool calls. Start with a run overview, then inspect relevant inputs, outputs, errors, and token use to explain what happened or diagnose a failure.

OriginalShow the original description

Analyze and answer questions about agent execution traces. Use this skill when the user asks about a trace, wants to debug a failed agent run, understand what an agent did, analyze token usage or efficiency, or asks "what happened in trace X". Triggers: trace analysis, trace debugging, trace QA, execution review, agent run review.

dp-archive/archive1,107 stars(GitHub 1,107 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Finding why an agent run failed
  • Reviewing the steps and tools an agent used
  • Checking token usage and efficiency

Files included (2)

  • SKILL.md3.1 KB
  • scripts/fetch_trace.py13.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Trace QA

Analyze agent execution traces to answer questions about what happened, why it failed, how efficient it was, or any other aspect of the run.

Workflow

Always start with overview to understand the trace before diving into details.

1. Get the overview first

python scripts/fetch_trace.py <trace_id> overview

This returns metadata (status, duration, tokens, model) and summaries (request, answer preview, tool usage counts). Use this to orient yourself before going deeper.

2. Explore steps or LLM calls as needed

Depending on the user's question, drill into the relevant data:

User wants to know...Command
What tools were called and in what ordersteps [start] [count]
Full input/output of a specific tool callstep <N>
How many LLM calls and their token costsllm-calls [start] [count]
What messages were sent to Claude in a specific turnllm-call <N>
Just the final resultanswer

3. Handle long content with segmented reads

When content is large, the script automatically segments output to ~4000 characters. If you see a [CONTINUED: ...] message at the end of output, call the command shown in that message to read the next segment. Repeat until all content is read.

Example sequence:

python scripts/fetch_trace.py <id> step 5
# Output ends with: [CONTINUED: use 'step 5 --offset 4000' for next segment]

python scripts/fetch_trace.py <id> step 5 --offset 4000
# Output ends with: [CONTINUED: use 'step 5 --offset 8000' for next segment]

python scripts/fetch_trace.py <id> step 5 --offset 8000
# Full content now read

Command Reference

ModeSyntaxDescription
overviewfetch_trace.py <id> overviewMetadata + summary stats
stepsfetch_trace.py <id> steps [start] [count]Paginated step list (default: 30/page)
stepfetch_trace.py <id> step <N> [--offset <chars>]Single step full content
llm-callsfetch_trace.py <id> llm-calls [start] [count]Paginated LLM call list
llm-callfetch_trace.py <id> llm-call <N> [--offset <chars>]Single LLM call full content
answerfetch_trace.py <id> answerFinal answer only

Common Analysis Patterns

Failure diagnosis: overview → find error → steps list → examine failing step detail

Token efficiency: overview (total tokens) → llm-calls list (per-call breakdown) → identify expensive calls

Behavior understanding: overview → steps list → step details for key tool calls

Tool usage audit: overview (tool summary) → steps list filtered by tool name

Environment

Set API_BASE_URL to override the default API endpoint (http://127.0.0.1:62610).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Review text for patterns associated with AI-generated writing, including vocabulary, structure, formatting, citations, and model-specific artifacts. The skill combines multiple signals, weighs context and mitigating evidence, and presents a cautious assessment with confidence and caveats.

  • Review an essay for multiple AI-writing signals
  • Explain which text patterns may suggest AI authorship
  • Assess a draft while accounting for false-positive risks
dp-archive/archive1.1KUpdated Mar 4, 2026

audio-extractor

FreeSummary

Extract audio from videos or download audio from supported websites with yt-dlp, then save it as MP3, M4A, FLAC, WAV, or OPUS. The workflow can embed track metadata and cover art, and process playlists or podcast episodes in batches.

  • Save a video's audio as MP3 or FLAC
  • Download podcast episodes as audio files
  • Convert a playlist into numbered audio tracks
dp-archive/archive1.1KUpdated Mar 4, 2026

biopython

FreeSummary

Use Biopython to process DNA, RNA, and protein sequences, read and convert common biology file formats, run alignments or BLAST searches, access NCBI records, and work with protein structures and phylogenetic trees in Python.

  • Reading and converting FASTA, GenBank, or PDB files
  • Calculating sequence statistics or translating DNA
  • Searching NCBI and PubMed records in batches
dp-archive/archive1.1KUpdated Mar 4, 2026

brand-identity

FreeSummary

Turn a project description into a coordinated visual identity package. Define logo variants, color palettes, and typography, then create layouts for business cards and social media covers along with a brand specification document for consistent use.

  • Creating a logo system and brand kit
  • Choosing colors and typography for a new project
  • Designing a business card and social media cover
dp-archive/archive1.1KUpdated Mar 4, 2026

canvas-design

FreeSummary

Create original posters and static artwork by first defining a visual direction for color, shape, space, and typography. Receive a Markdown design philosophy alongside a PNG or PDF artwork that communicates primarily through visuals.

  • Create an original poster
  • Express a theme through abstract artwork
  • Develop a visual direction and finished artwork
dp-archive/archive1.1KUpdated Mar 4, 2026

code-to-diagram

FreeSummary

Turn a codebase into Mermaid diagrams such as architecture, ER, sequence, class, and flow diagrams. It analyzes relevant files, writes diagram source, renders SVG and PNG images, and checks the rendered result for readability and correctness.

  • Visualize a codebase architecture
  • Create an ER diagram from database models
  • Show an API flow as a sequence diagram
dp-archive/archive1.1KUpdated Mar 4, 2026

See all skills by dp-archive

Report a problem with this skill