seokan-jeong/team-shinchan:analytics

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