session-scan
Compute metrics for Claude Code sessions. Discovers via ccrider, filters trivial, computes friction/opportunity/fingerprint scores. Use for broad session triage.
npx skills add oliver-kriska/claude-elixir-phoenix --skill session-scan --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Session Scan (Tier 1) Compute deterministic metrics for sessions discovered via ccrider MCP. ## STOP — Read Before Executing **NEVER call `mcp__ccrider__get_session_messages` in main context.** Each response is 5-50KB of JSON. Fetching N sessions directly = context crash. **You MUST delegate all scoring to subagents.** The main context only does: discovery, deduplication, subagent spawning, and result collection. ## Requirements Requires **ccrider MCP**. If not available: > ccrider MCP is required. See: <https://github.com/neilberkman/ccrider> ## Usage ``` /session-scan # Last 7 days, up to 50 sessions /session-scan --since 2026-02-01 # Since specific date /session-scan --project enaia # Filter by project name /session-scan --limit 20 # Cap session count /session-scan --list # Discovery only, no scoring /session-scan --rescan # Recompute already-scanned sessions ``` ## What Main Context Does ### 1. Parse Arguments Extract from `$ARGUMENTS`: - **`--since DATE`**: ISO date filter (default: 7 days ago) - **`--project NAME`**: Filter by project path substring - **`--limit N`**: Max sessions to process (default: 50) - **`--list`**: Discovery only — show table, skip scoring - **`--resc
- STOP — Read Before Executing
- Requirements
- Usage
- What Main Context Does
- 1. Parse Arguments
- 2. Discover Sessions (safe — response is ~1KB)
- 3. Deduplicate
- 4. Resolve Scorer Path
- 5. Spawn ONE Subagent Per Session
- 6. Collect Results
- 7. Display Results
- 8. Update Scan Metadata
- Scoring Reference
- Iron Laws
for f in .claude/session-metrics/_result_*.json; do cat "$f" >> .claude/session-metrics/metrics.jsonl rm "$f" done
What does the session-scan skill do?
Compute metrics for Claude Code sessions. Discovers via ccrider, filters trivial, computes friction/opportunity/fingerprint scores. Use for broad session triage.
How do I install it?
Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill session-scan --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From oliver-kriska/claude-elixir-phoenix, a repository with 515 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.