Skip to content
Back to search

reportsmith

MarketplaceWorks with Claude CodeGitHub

Work reports from git and coding-agent sessions.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mesubash/reportsmith with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mesubash/reportsmith'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mesubash--reportsmith/badge.svg)](/listings/mesubash--reportsmith)

HTML

<a href="/listings/mesubash--reportsmith"><img src="/api/listings/mesubash--reportsmith/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Pick your agent and copy one block.

Claude Code

Run inside Claude Code:

/plugin marketplace add mesubash/reportsmith
/plugin install reportsmith@reportsmith

<details> <summary>Without the plugin system</summary>

git clone https://github.com/mesubash/reportsmith.git ~/.reportsmith-src
ln -s ~/.reportsmith-src/skills/reportsmith ~/.claude/skills/reportsmith

</details>

Codex

Uses Codex's built-in skill installer:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo mesubash/reportsmith --path skills/reportsmith --name reportsmith

opencode

git clone https://github.com/mesubash/reportsmith.git ~/.reportsmith-src
mkdir -p ~/.config/opencode/skills
ln -s ~/.reportsmith-src/skills/reportsmith ~/.config/opencode/skills/reportsmith

opencode also loads skills from `~/.claude/skills/`, so if you installed it for Claude Code without the plugin system, opencode already has it.

Other agents

Any agent that reads Agent Skills (`SKILL.md`), with the [skills CLI](https://skills.sh):

npx skills add mesubash/reportsmith

<details> <summary>Agents without skill support</summary>

Clone the repo anywhere and add this line to your `AGENTS.md`:

For standups, status reports, changelogs or release notes, follow ~/.reportsmith-src/skills/reportsmith/SKILL.md

</details>

**Requirements:** `git` and `python3` (3.10 or newer, standard library only). `gh` is used for PRs and reviews if you have it.

Try it

In any repo, ask your agent:

standup

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "reportsmith",
  4. "description": "Work reports from git and coding-agent sessions.",
  5. "owner": {
  6. "name": "Subash Singh Dhami",
  7. "url": "https://github.com/mesubash"
  8. },
  9. "plugins": [
  10. {
  11. "name": "reportsmith",
  12. "description": "Standups, daily logs, weekly and monthly reports, changelogs and release notes from git and your coding agents' sessions, published through MCP.",
  13. "source": "./",
  14. "category": "productivity",
  15. "keywords": [
  16. "standup",
  17. "weekly-report",
  18. "changelog",
  19. "release-notes",
  20. "worklog",
  21. "mcp"
  22. ]
  23. }
  24. ]
  25. }
README.md · README · 228 lines
  1. <p align="center">
  2. <img src="assets/banner.svg" alt="reportsmith: standups, weekly reports, changelogs and release notes from git and your coding-agent sessions" width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/mesubash/reportsmith/releases/latest"><img src="https://img.shields.io/github/v/release/mesubash/reportsmith?label=release&color=58a6ff" alt="Latest release"></a>
  6. <a href="https://github.com/mesubash/reportsmith/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/mesubash/reportsmith/test.yml?branch=main&label=tests" alt="Tests"></a>
  7. <a href="LICENSE"><img src="https://img.shields.io/github/license/mesubash/reportsmith?color=3fb950" alt="MIT license"></a>
  8. <a href="https://agentskills.io"><img src="https://img.shields.io/badge/Agent%20Skill-SKILL.md-8957e5" alt="Agent Skill"></a>
  9. <a href="https://github.com/mesubash/reportsmith/blob/traffic/daily.csv"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2Fmesubash%2Freportsmith%2Ftraffic%2Fbadge-clones.json" alt="Total clones"></a>
  10. </p>
  11. <p align="center">
  12. <a href="#install">Install</a> ·
  13. <a href="#example">Example</a> ·
  14. <a href="#use">Use</a> ·
  15. <a href="#configure">Configure</a> ·
  16. <a href="SECURITY.md">Privacy</a> ·
  17. <a href="CONTRIBUTING.md">Contribute</a>
  18. </p>
  19. **reportsmith** writes your standups, daily logs, weekly and monthly reports, changelogs and release notes. It reads what you actually did in a folder: your git commits **and the session logs your coding agents already keep**, so work that never reached a commit (incidents, reviews, server fixes, investigations) shows up too.
  20. It is an open [Agent Skill](https://agentskills.io) for **Claude Code**, **Codex**, **opencode** and other AI coding agents. Reports come out in plain human wording, or in your own style, and can be published through any MCP server (Slack, Notion, Plane, Google Drive and more). No server, no database, no tracking: it runs when you ask, makes a report, and stops.
  21. ## Install
  22. Pick your agent and copy one block.
  23. ### Claude Code
  24. Run inside Claude Code:
  25. ```
  26. /plugin marketplace add mesubash/reportsmith
  27. ```
  28. ```
  29. /plugin install reportsmith@reportsmith
  30. ```
  31. <details>
  32. <summary>Without the plugin system</summary>
  33. ```sh
  34. git clone https://github.com/mesubash/reportsmith.git ~/.reportsmith-src
  35. ln -s ~/.reportsmith-src/skills/reportsmith ~/.claude/skills/reportsmith
  36. ```
  37. </details>
  38. ### Codex
  39. Uses Codex's built-in skill installer:
  40. ```sh
  41. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py --repo mesubash/reportsmith --path skills/reportsmith --name reportsmith
  42. ```
  43. ### opencode
  44. ```sh
  45. git clone https://github.com/mesubash/reportsmith.git ~/.reportsmith-src
  46. mkdir -p ~/.config/opencode/skills
  47. ln -s ~/.reportsmith-src/skills/reportsmith ~/.config/opencode/skills/reportsmith
  48. ```
  49. opencode also loads skills from `~/.claude/skills/`, so if you installed it for Claude Code without the plugin system, opencode already has it.
  50. ### Other agents
  51. Any agent that reads Agent Skills (`SKILL.md`), with the [skills CLI](https://skills.sh):
  52. ```sh
  53. npx skills add mesubash/reportsmith
  54. ```
  55. <details>
  56. <summary>Agents without skill support</summary>
  57. Clone the repo anywhere and add this line to your `AGENTS.md`:
  58. ```
  59. For standups, status reports, changelogs or release notes, follow ~/.reportsmith-src/skills/reportsmith/SKILL.md
  60. ```
  61. </details>
  62. **Requirements:** `git` and `python3` (3.10 or newer, standard library only). `gh` is used for PRs and reviews if you have it.
  63. ### Try it
  64. In any repo, ask your agent:
  65. ```
  66. standup
  67. ```
  68. ## Example
  69. You ask: *"standup for 2026-03-10, scope ~/work/app"*. That day the repo has two of your commits (one cherry-picked onto a second branch), a teammate's commit and a commit from the next day. You also had a Claude Code session that restarted a stuck worker and was then asked about a failed backup.
  70. reportsmith writes:
  71. ```
  72. Standup, 2026-03-10 (Tue)
  73. Scope: app · Sources: git, Claude Code sessions
  74. Yesterday
  75. - Fixed duplicate card charges: a second charge can no longer start while the
  76. first is still unconfirmed (PAY-12, f0b6394).
  77. - Added CSV export of invoices (INV-7, 7f61aa0).
  78. - Restarted the stuck invoice queue worker on staging. 214 queued jobs drained
  79. and the queue is now empty.
  80. To confirm
  81. - Nightly backup failure: asked to look into it; the session does not say what
  82. was found or whether it was fixed.
  83. ```
  84. The cherry-picked fix appears once, the teammate's commit and the next day's commit are left out, the restart shows up although it never reached git, and the backup question is not claimed as done. This exact case runs as an end-to-end eval in [`evals/standup-fixed-day`](evals/standup-fixed-day).
  85. ## Use
  86. Ask in plain words:
  87. | You say | You get |
  88. |---|---|
  89. | `standup` | yesterday and today, short |
  90. | `what did I do yesterday in ~/work/api` | one day, one repo |
  91. | `weekly report for my manager, last week` | outcomes and risks, no code detail |
  92. | `monthly report for October, scope ~/clients/acme` | one client, rolled up by theme |
  93. | `changelog since v1.2` / `release notes for v2.0` | user-facing changes from the tag range |
  94. | `daily log, then post it to #eng` | publishes after you approve the preview |
  95. Any period works: a day, a week, a month, a quarter, `last 10 days`, or `Nov 1 to Nov 15`.
  96. ## What it reads
  97. ```
  98. scope: a folder, any period
  99. sources render publish
  100. ─────── ────── ───────
  101. git (every repo in scope) ─┐ ┌─► file (default)
  102. agent sessions in scope ─┤ ├─► any MCP tool: Slack, Notion,
  103. (Claude Code, Codex, ├─► template + config ─► │ Plane, Google Drive, …
  104. opencode) │ preview / confirm │
  105. agent memory (claude-mem) ─┤ ├─► webhook
  106. PRs, tickets, notes ─┘ └─► shell command (e.g. gh release)
  107. ```
  108. - **Folder scope.** `~/work` for your job, `~/side-project` for yourself, one folder per client. Every repo underneath is found automatically.
  109. - **Honest.** Never invents items. Something an agent was asked to do counts as done only if a commit or the agent's final answer confirms it.
  110. - **Reads like you wrote it.** Plain-wording rules are built in, and `style.sample` can point at your own past reports to copy your voice.
  111. - **Private by default.** Secrets and IPs are removed before drafting, and nothing is published without your approval. See [SECURITY.md](SECURITY.md).
  112. ## Configure
  113. Everything is optional. Copy [`config.example.yml`](skills/reportsmith/config.example.yml) to `~/.reportsmith/config.yml` (global) or `.reportsmith.yml` (one repo) and keep only what you change.
  114. | You want | Set |
  115. |---|---|
  116. | Only count work in some folders | `scope.include`, `scope.exclude` |
  117. | Reports that sound like you | `style.sample`, `style.voice`, `style.rules` |
  118. | Your own report format | `templates_dir`, or `~/.reportsmith/templates/<kind>.md` |
  119. | Reports saved in your own layout | `reports.<kind>.output`, e.g. `~/notes/{{yyyy}}/{{mm}}/{{dd}}.md` |
  120. | Reports posted somewhere | `destinations` and `reports.<kind>.publish` ([how](skills/reportsmith/publishing.md)) |
  121. | A new kind of report | add `templates/<kind>.md`, then ask for it by name |
  122. <details>
  123. <summary>Publishing destinations</summary>
  124. Destinations are set once and used by name. Recipes exist for Slack, Notion, GitHub, Plane, Google Drive, Claude Docs and Discord; any other MCP server works through the [generic recipe](skills/reportsmith/destinations/_generic.md).
  125. ```yaml
  126. destinations:
  127. team-chat: { via: mcp, server: slack, action: send message, channel: "#standup" }
  128. wiki: { via: mcp, server: notion, action: create page, parent: "Weekly reports" }
  129. hook: { via: webhook, url_env: REPORT_WEBHOOK }
  130. reports:
  131. standup: { publish: [team-chat] }
  132. weekly: { publish: [wiki] }
  133. ```
  134. </details>
  135. <details>
  136. <summary>Run on a schedule (cron, CI)</summary>
  137. Set `publish.confirm: false` in that run's config, and allow the tools it needs.
  138. ```sh
  139. # Claude Code, every Friday at 17:00
  140. 0 17 * * 5 cd ~/work && claude -p "weekly report for this week, publish" --allowedTools "Bash(git:*)" "Bash(python3:*)" "Bash(gh:*)" "mcp__slack"
  141. ```
  142. ```sh
  143. # Codex, every Friday at 17:00
  144. 0 17 * * 5 codex exec -C ~/work "weekly report for this week, publish"
  145. ```
  146. In unattended runs reportsmith never asks: if something is missing (scope, range, an MCP server), it stops and says why.
  147. </details>
  148. <details>
  149. <summary>Config stability</summary>
  150. `version: 1` is the current config format. Within version 1, a key never changes meaning or disappears; a renamed key keeps working under its old name, with a note, until the next format version. Anything that breaks existing configs bumps `version` and is listed in the [changelog](CHANGELOG.md).
  151. </details>
  152. ## Not included, on purpose
  153. Activity or time tracking, productivity metrics, a stored history of your work, a hosted service.
  154. ## Contributing
  155. New destination recipes (Jira, Confluence, Linear) and session readers (Cursor) are the most useful contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) and the [open issues](https://github.com/mesubash/reportsmith/issues).
  156. ## Credits
  157. Writing rules adapted from [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing).
  158. ## License
  159. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.