mentor
mentor is a skill for AI coding agents: Claude Code, Codex, and any other agent that reads the SKILL.md format. The skill reads your own local session history and writes one self-contained HTML report on how you actually work: what you build, where you lose time, and the exact changes that make you faster. It is a session-insights skill modeled on Claude Code's built-in /insights, pointed at the one part of the loop you never instrument, yourself.
Agents now do the work juniors used to. But juniors became seniors by getting feedback from seniors. Give agents to juniors and retire the seniors, and that feedback loop disappears. This skill is that loop, packaged as an agent skill you install once and run every week.
What the skill does
- Reads your local session history. Claude Code transcripts under
~/.claudeand Codex rollouts under~/.codex. Nothing is uploaded; the skill runs entirely on your machine. - Aggregates many sessions into headline numbers (messages, sessions, tool calls, edits, files touched, tokens) plus per-day activity, tool mix, and languages.
- Writes one self-contained
report.htmlwith eight sections, inline SVG icons, count-up numbers, and an animated chart. No dependencies and no build step, so any browser opens it.
| Section | What it gives you |
|---|---|
| What you work on | Your sessions clustered into themes, with rough share |
| How you use the agent | Tool ratios, languages, model tiering, checkpoints |
| What you did well | Real wins, handed back |
| Where things go wrong | Friction points, each with evidence and a concrete fix |
| Features worth trying | Capabilities you under-use |
| Suggested CLAUDE.md additions | Copy-paste lines that kill a recurring friction |
| New ways to use it | Better workflows for your patterns |
| On the horizon | Where your workflow is heading |
The friction section is the point of the skill: every friction names a repeatable fix, a CLAUDE.md line, a hook, or a habit, so the same mistake stops showing up next week.
Install the skill
Recommended, via skills.sh, the open marketplace for agent skills. One command installs the skill into any supported agent:
npx skills add smixs/mentor
Useful flags:
# globally, for every project
npx skills add smixs/mentor -g
# into specific agents
npx skills add smixs/mentor -a claude-code -a codex
# no questions, for CI
npx skills add smixs/mentor -g -y
Update the skill to the latest version: npx skills update mentor.
Manual (Claude Code) clones the skill straight into your skills directory:
git clone https://github.com/smixs/mentor.git ~/.claude/skills/mentor
For Codex, clone the skill into ~/.codex/skills/mentor instead. The bundled scripts need uv; the skill itself is plain Markdown that any skills-capable agent can read.
Use the skill
Run the command, or just ask the agent for it in your own words ("review how I work with the agent", "разбери мои сессии"):
/mentor # both agents, last 30 days (default)
/mentor claude # Claude Code sessions only
/mentor codex # OpenAI Codex sessions only
/mentor both # cross-agent read: habits that show up in both tools
Add a window with --days N. The skill writes the report to ~/.claude/usage-data/mentor-report.html and opens it. Make the skill a weekly habit, since the patterns show up over runs, not in a single one:
claude -p "/mentor both"
How the skill works
Three small scripts, no magic:
collect.pyparses every session in the window into one stats bundle. The numbers are counted, not guessed.- The agent reads that digest and writes the eight-section analysis, grounded in your actual prompts and metrics.
render_report.pymerges stats and analysis into the final HTML.
The report is written in your language (English by default; Russian chrome is built into the skill). Some judgments, like themes and satisfaction, are model-inferred and flagged as such; read them as hypotheses, not verdicts.
Privacy
The skill reads local log files and writes a local HTML file. Your transcripts never leave your machine.
License
MIT, see LICENSE. Русская версия: README.ru.md.