Skill Tail

Track skill usage and Codex session delegation statistics.

Features

• Keep existing all-time, daily, and weekly skill reports.
• Track the active Codex primary model by conversation.
• Count all spawned subtasks and the subset run by luna_worker or gpt-5.6-luna.
• Preserve old skill history by migrating ~/.claude/skills/skill-tail/stats.json on first use.

Commands

# Record skill usage. Existing workflow remains valid.
npx skill-tail record openai-docs

# Register the current conversation's primary model.
npx skill-tail session --model gpt-5.6-sol

# Record every spawned subtask. Luna is detected by agent or model name.
npx skill-tail subtask luna_worker --model gpt-5.6-luna

# If current-session telemetry exists, show it. Otherwise show the original skill report.
npx skill-tail report

# Force current-session telemetry output.
npx skill-tail report --current

# Original filtered reports remain available.
npx skill-tail report --today
npx skill-tail report --week
npx skill-tail report --json

CODEX_THREAD_ID supplies the session identifier automatically. Use --session <id> only when recording or querying another conversation.

Storage

Statistics are stored in ~/.codex/skill-tail/stats.json. On first use, the CLI migrates the legacy skill counters from ~/.claude/skills/skill-tail/stats.json when present.

License

MIT