# Session

> Claude Code session analytics - post stats to PRs/issues, extract to CSV Use when this capability is needed.

- Skill: `tomevault-io/session` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/session`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/session/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/session

---


```mermaid
flowchart TD
    INVOKE(["/session"]) --> DECIDE{"What does the user want?"}
    DECIDE -->|Post current session stats| POST["session:post"]:::phase
    DECIDE -->|Update pinned summary| SUMMARY["session:summary"]:::phase
    DECIDE -->|Extract analytics to CSV/MD/HTML| EXTRACT["session:extract"]:::phase
    DECIDE -->|Generate dashboard| DASHBOARD["session:dashboard"]:::phase

    POST --> DONE([Done])
    SUMMARY --> DONE
    EXTRACT --> DONE
    DASHBOARD --> DONE

    classDef phase fill:#2196F3,stroke:#333,color:white
```

> Follow this diagram as the workflow.

# Session Analytics

Track and report Claude Code session metadata on GitHub PRs and issues.

## Auto-Select Sub-Skill

When this skill is invoked, determine the right sub-skill based on context:

```
What does the user want?
    |
    +- Post current session stats to a PR/issue
    |   -> Use `session:post`
    |
    +- Update the pinned summary comment on a PR/issue
    |   -> Use `session:summary`
    |
    +- Extract analytics to CSV/MD/HTML files
    |   -> Use `session:extract`
    |
    +- Generate an HTML dashboard
        -> Use `session:dashboard`
```

## Available Skills

| Skill | Purpose | When |
|-------|---------|------|
| `session:post` | Post session stats to PR/issue comment | After a session, want to record stats |
| `session:summary` | Update pinned summary comment | Refresh aggregated stats on PR/issue |
| `session:extract` | Extract analytics to CSV/MD/HTML | Need offline analysis or reporting |
| `session:dashboard` | Generate HTML dashboard | Visual overview of session metrics |

## Quick Post

```bash
# Post current session stats to the PR for the current branch
python3 .claude/scripts/session-analytics.py --session-id <ID> --target pr --number <N> --repo <OWNER/NAME>
```

## Related Skills

- `session:post` - Post session stats to PR/issue comment
- `session:summary` - Update pinned summary comment
- `session:extract` - Extract analytics to CSV/MD/HTML
- `session:dashboard` - Generate HTML dashboard

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/kagenti) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->