Agent skill

Monthly Review

by hoangsonww in hoangsonww/Claude-Code-Agent-Monitor

Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month.

MITAuto-check passedProduct & Project Management

Install Monthly Review

skills CLI
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill monthly-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor monthly-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-productivity/skills/monthly-review .claude/skills/monthly-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
monthly-review
GitHub stars
1.1k
Token cost
~836 tokens
SKILL.md length
372 words
Files
2
Skills in repo
78
Repo updated
First seen
Licence
MIT

At a glance

Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month.

  • Works in 6 steps: Month at a Glance → Top Projects (by cwd) → Cost & Token Breakdown → …
  • Doing a monthly retrospective
  • SKILL.md covers Input, Data Sources, Report Sections and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Monthly Review is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month. Uses dailysessions/dailyevents (365d) from analytics, the session list, and the pricing cost breakdown. Use when doing a monthly retrospective or planning the month ahead.

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Product & Project Management, covering Retrospectives. The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.

When your agent uses it

  • Doing a monthly retrospective
  • Planning the month ahead

Example prompts

  • “/monthly-review”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Month at a Glance
  2. Top Projects (by cwd)
  3. Cost & Token Breakdown
  4. Tool & Workflow Shifts
  5. Notable Shifts & Narrative
  6. Focus for Next Month

What it can do on your machine

Read from SKILL.md and the folder at commit a06db03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Monthly Review loads about 836 tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 372 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~836

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hoangsonww/Claude-Code-Agent-Monitor at commit a06db03, republished under its MIT licence (© hoangsonww). 372 words, ~836 tokens.

Download SKILL.mdSave it as .claude/skills/monthly-review/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
monthly-review
description
Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month. Uses daily_sessions/daily_events (365d) from analytics, the session list, and the pricing cost breakdown. Use when doing a monthly retrospective or planning the month ahead.

Monthly Review

Generate a month-over-month productivity retrospective from Agent Monitor data.

Input

The user provides: $ARGUMENTS

This may be:

  • "this month" or empty (default: the current calendar month to date)
  • "last month" for the previous full calendar month
  • A specific month: "2026-02" or "February 2026"

The comparison period is always the immediately preceding calendar month.

Data Sources

EndpointReturns
GET /api/analyticsdaily_sessions and daily_events (365d) for monthly bucketing and trends; tokens (total_input/output/cache_read/cache_write — baselines pre-summed); tool_usage (top 20); sessions_by_status
GET /api/sessions?limit=500Sessions with started_at, ended_at, status, model, cwd, cost, and metadata (turn_count, thinking_blocks) — for per-project (cwd) grouping and completion rate
GET /api/pricing/costtotal_cost and per-model breakdown (input/output/cache tokens, cost, matched_rule)

Report Sections

1. Month at a Glance

Compare the target month to the prior month in a table:

MetricThis MonthLast MonthChange
SessionsNN▲/▼ N%
Total Cost$X.XXXX$X.XXXX▲/▼ N%
Tokens (in/out/cache)NN▲/▼ N%
Completion RateN%N%▲/▼ N pts
Active DaysNN▲/▼

Derive monthly buckets from daily_sessions / daily_events. Completion rate = completed sessions / total sessions for the month (from sessions_by_status and the filtered session list).

2. Top Projects (by cwd)

Group the month's sessions by cwd. For the top 5–8 projects, list session count, total cost, completion rate, and dominant model. Note any project that newly appeared or dropped off versus last month.

Show full SKILL.md (155 more words)Show less
3. Cost & Token Breakdown

From /api/pricing/cost, show cost per model and the dominant token type. Compute cache hit rate = total_cache_read / (total_cache_read + total_input) and compare to last month. Currency to 4 decimals.

4. Tool & Workflow Shifts

From tool_usage, highlight the tools that rose or fell most month-over-month, and any new tool adopted. Flag rising error/Compaction activity if present.

5. Notable Shifts & Narrative

Three to five plain-language observations: what changed, why it likely changed, and what it implies (e.g., "cost up 22% but sessions flat → heavier per-session work").

6. Focus for Next Month

Two to four prioritized, actionable goals grounded in the numbers above.

Output

  • Markdown report with emoji-light, scannable section headers.
  • Tables for all month-over-month comparisons; ▲ / ▼ for deltas.
  • Currency in USD to 4 decimals; tokens with thousands separators.
  • Lead with a 2–3 sentence executive summary, then the sections in order.
  • Cite only numbers returned by the API; if a month has no data, say so explicitly.

© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ccam-productivity/skills/monthly-review of hoangsonww/Claude-Code-Agent-Monitor.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit a06db03

Compare with similar skills

Monthly Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Monthly Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Monthly Review this skillhoangsonww/Claude-Code-Agent-Monitor1.1k—~836Automated safety check: PassMIT
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
Dough Execute Planterryyin/lizard2.5k—~4.3kAutomated safety check: PassCustom licence
Oral Paper SkillAdkid-Zephyr/oral-paper-skill357—~1.9kAutomated safety check: PassNone
Deck Retroasheshgoplani/agent-deck1.1k—~1.8kAutomated safety check: PassMIT
Dough Execution Retrospectiveterryyin/lizard2.5k—~4kAutomated safety check: PassCustom licence

Similar skills

  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Dough Execute Plan

    terryyin/lizard

    Executes one selected story or bounded retrospective correction through an executable plan, or one authorized planless slice from a selected simple story or a contextual instruction, with…

    2.5k GitHub stars~4.3k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Oral Paper Skill

    Adkid-Zephyr/oral-paper-skill

    Help authors learn from exemplary ICLR, ICML, and NeurIPS papers through source-linked manuscript comparisons, concrete writing and experiment suggestions, and guided reflection.

    357 GitHub stars~1.9k tokensUpdated 23 days ago
    Product & Project ManagementAuto-check passed
  • Deck Retro

    asheshgoplani/agent-deck

    Run a fully local agent-deck retrospective over the user's own transcripts, Recall index and logs.

    1.1k GitHub stars~1.8k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Reviews planned, completed planless quick, or quick-to-planned execution against original intent, aggregate commits, current whole-product architecture, and tests, including after cleanup.

    2.5k GitHub stars~4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Criticism Self Criticism

    HughYau/qiushi-skill

    批评与自我批评:在工作完成、阶段验收、收到批评或同类错误反复出现时,对成果和过程做诚实、具体、基于事实的审视,输出可执行的改进项,并处理外来批评而不辩解。触发信号包括 review、复盘、审查、"帮我看看有没有问题"、"你确定吗";任务刚开始或只是单步查询时不触发。

    3.8k GitHub stars~423 tokensUpdated 10 days ago
    Product & Project ManagementAuto-check passed

More from hoangsonww/Claude-Code-Agent-Monitor

All 78 skills in this repo
  • Version Release

    hoangsonww/Claude-Code-Agent-Monitor

    Choose and apply the correct semantic version bump for this repository.

    1.1k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Budget Set

    hoangsonww/Claude-Code-Agent-Monitor

    Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.

    1.1k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Cache Efficiency

    hoangsonww/Claude-Code-Agent-Monitor

    Analyze prompt-cache effectiveness for Claude Code usage from the Agent Monitor dashboard — cache hit rate (totalcacheread / (totalcacheread + totalinput)), cachewrite vs cacheread reuse, cache-read…

    1.1k GitHub stars~966 tokensUpdated yesterday
    Auto-check passed
  • Cost Breakdown

    hoangsonww/Claude-Code-Agent-Monitor

    Break down Claude Code costs using the Agent Monitor pricing engine.

    1.1k GitHub stars~845 tokensUpdated yesterday
    Auto-check passed
  • Dag Map

    hoangsonww/Claude-Code-Agent-Monitor

    Render the multi-agent orchestration DAG for a session — parent→child subagent edges, tree depth, and fan-out — from the Agent Monitor workflow intelligence API.

    1.1k GitHub stars~564 tokensUpdated yesterday
    Auto-check passed
  • Dashboard Status

    hoangsonww/Claude-Code-Agent-Monitor

    Quick dashboard health and status overview — checks the Agent Monitor API (port 4820), reports session/agent/event counts from /api/stats, confirms WebSocket connectivity, reads the redacted hook…

    1.1k GitHub stars~600 tokensUpdated yesterday
    Auto-check passed

Questions about Monthly Review

What does Monthly Review do?

Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month. Monthly Review is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Compile a month-over-month retrospective from Agent Monitor data — sessions, cost, token volumes, completion rate, top projects by working directory, and notable shifts versus the prior month.

When should I use Monthly Review?

Monthly Review fits situations like: doing a monthly retrospective; planning the month ahead.

How do I install Monthly Review in Claude Code?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill monthly-review -a claude-code`. Or copy the skill folder (plugins/ccam-productivity/skills/monthly-review in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/monthly-review in your project. Claude Code loads it when a task matches its description.

How do I install Monthly Review in Codex?

Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill monthly-review -a codex`. Or copy the skill folder (plugins/ccam-productivity/skills/monthly-review in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/monthly-review in your project. Codex loads it when a task matches its description.

Can I use Monthly Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill monthly-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/monthly-review, .gemini/skills/monthly-review, .github/skills/monthly-review and .opencode/skills/monthly-review in your project.

What does Monthly Review need to run?

SKILL.md names no scripts, command-line tools or credentials: Monthly Review is instructions for the agent only.

Does Monthly Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Monthly Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Monthly Review use?

Monthly Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Monthly Review use?

About 836 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Monthly Review?

Skills that share tags, products or a category with Monthly Review: Weekly Engineering Retro (garrytan/gstack, 136k stars), Dough Execute Plan (terryyin/lizard, 2.5k stars), Oral Paper Skill (Adkid-Zephyr/oral-paper-skill, 357 stars) and Deck Retro (asheshgoplani/agent-deck, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Monthly Review?

hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,058 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 10, 2026.

Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.