| name | team-shinchan:analytics |
| description | Use when you need to analyze work tracker data for agent metrics or session stats. |
| user-invocable | false |
Analytics Skill
Analyze work tracker events for observability insights.
Usage
/team-shinchan:analytics
/team-shinchan:analytics --report full
/team-shinchan:analytics --agent bo
/team-shinchan:analytics --trace trace-xxx
/team-shinchan:analytics --period 7d
Arguments
| Arg | Default | Description |
|---|
--report full | (session) | Generate full analytics report |
--agent {name} | (all) | Detail for a single agent |
--trace {id} | (none) | Timeline for a specific trace ID |
--period {N}d | (all) | Filter events to the last N days |
--format table | json | Output as text table instead of JSON |
Process
Step 1: Locate Tracker File
Use .shinchan-docs/work-tracker.jsonl as the data source.
If file does not exist:
No work tracker log found.
Events will be recorded automatically during Claude Code sessions.
Step 2: Run Analytics Script
Execute the analytics script via Bash:
node "${CLAUDE_PLUGIN_ROOT}/src/analytics.js" .shinchan-docs/work-tracker.jsonl [options]
Map user arguments to script flags:
--report full → no extra flags (full report is default)
--agent <name> → --agent <name>
--trace <id> → --trace <id>
--period <N>d → --period <N>d
- Default (no args) →
--format table
Step 3: Display Results
- For
--format table or default: display the text table output directly
- For JSON output: format and display key sections with headers
Step 4: Interpret Results
After displaying raw output, provide a brief interpretation:
- Highlight busiest agents
- Note any agents with low success rates
- Summarize delegation patterns
- Flag anomalies (e.g. agents with 0 completions)
Metrics Computed
| Metric | Description |
|---|
| Agent call count | How many times each agent was invoked |
| Avg duration | Average time from agent_start to agent_done |
| Success rate | Ratio of agent_done to agent_start |
| Session stats | Events, file changes, delegations per session |
| Event distribution | Percentage breakdown of event types |
| Delegation graph | Which agent delegated to which, with counts |
Important
- Analytics script:
src/analytics.js (Node.js, built-in modules only)
- Data source:
.shinchan-docs/work-tracker.jsonl
- Trace IDs: generated per user prompt via
trace-init hook