team-shinchananalytics

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                        # Current session summary
/team-shinchan:analytics --report full          # Full analytics report
/team-shinchan:analytics --agent bo             # Single agent detail
/team-shinchan:analytics --trace trace-xxx      # Trace timeline
/team-shinchan:analytics --period 7d            # Last 7 days only

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