Agent skill

Nippo Daily Report Generator

by nwiizo in nwiizo/nippo

Generates daily reports, reflections, weekly reports, self-reviews and trend insights, in Japanese, from Claude Code, Codex and opencode session logs using the nippo CLI.

MITAuto-check passedProductivity & Automation

SKILL.md written in Japanese; this summary is our English description.

Install Nippo Daily Report Generator

skills CLI
$ npx skills add nwiizo/nippo --skill nippo -a claude-code

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

GitHub CLI
$ gh skill install nwiizo/nippo nippo --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/nwiizo/nippo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/nippo .claude/skills/nippo && 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
nippo
GitHub stars
180
Token cost
~1.7k tokens
SKILL.md length
486 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Generates daily reports, reflections, weekly reports, self-reviews and trend insights, in Japanese, from Claude Code, Codex and opencode session logs using the nippo CLI.

  • Works in 3 steps: mkdir -p tmp を実行する。このリポジトリ内なら cargo run… → tmp/nippo-raw.json を Read… → モードに対応するテンプレートを Read で読み込む
  • Writing a daily work report from today's agent sessions
  • SKILL.md covers ルール, モード決定, 収集と生成 and 改善提案と Issue 作成
  • Calls cargo and gh

What it does

The SKILL.md is in Japanese. The first word of the arguments picks a mode: daily (the default), brief, reflection, guide, report, review, insight, trend, plan or ledger. Each mode has a default period, such as one day for a daily report, 7 days for a report or insight, 90 days for a review, and a trend that splits 90 days into three spans. Data is collected only with the nippo CLI, Python is forbidden, and the aggregated stats are quoted directly rather than recalculated.

Reports are written in Japanese into a reports folder as mode and date files. The temporary raw JSON file is deleted after saving, even on failure. For Codex the collector reads history, SQLite state and rollout data, the current session is excluded, and sparse metrics are stated openly rather than invented. In the nippo repository it prefers cargo run over the global binary. The plan mode reads the latest existing report without collecting. The excerpt is cut off in the mode table.

When your agent uses it

  • Writing a daily work report from today's agent sessions
  • Preparing a weekly progress report from recent session logs
  • Doing a longer self-review or trend analysis of how your work changed
  • Generating reflection questions or a morning action plan from past work

Example prompts

  • “/nippo daily to write today's report from my agent sessions.”
  • “Write this week's progress report from my agent session logs.”
  • “/nippo trend to show how my work changed over the last 90 days.”
  • “/nippo reflection and give me questions to think about from today's sessions.”

Requirements

  • The nippo CLI, or cargo to run it from the repository
  • Session logs from Claude Code, Codex or opencode
  • Pre-approved tools (allowed-tools): Read, Write, Glob, Bash(nippo *), Bash(cargo run -q -p nippo *), Bash(mkdir -p reports), Bash(mkdir -p tmp), Bash(rm -f tmp/nippo-raw.json), Bash(gh issue list *), Bash(gh issue create *)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. mkdir -p tmp を実行する。このリポジトリ内なら cargo run -q -p nippo -- collect ...、それ以外は nippo collect ... を Bash で 1 回実行し、JSON を tmp/nippo-raw.json…
  2. tmp/nippo-raw.json を Read で読み込む。大きい場合は分割して読み、途中で切れた Bash 出力から JSON を推測しない
  3. モードに対応するテンプレートを Read で読み込む

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • Bash(nippo *)
    • Bash(cargo run -q -p nippo *)
    • Bash(mkdir -p reports)
    • Bash(mkdir -p tmp)
    • Bash(rm -f tmp/nippo-raw.json)
    • Bash(gh issue list *)
    • Bash(gh issue create *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    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

Nippo Daily Report Generator loads about 1.7k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 486 words of instructions outside code blocks.

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

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 nwiizo/nippo at commit cdd521d, republished under its MIT licence (© nwiizo). 486 words, ~1,680 tokens.

Download SKILL.mdSave it as .claude/skills/nippo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
nippo
description
ユーザーが日報・振り返り・作業まとめ・週報・自己評価を求めたときに、 Claude Code / Codex / opencode のセッションログから日報・リフレクション・インサイトを生成する。 /nippo と /nippo daily で日報、/nippo reflection で内省の問い、/nippo guide で学習支援、 /nippo report で進捗報告、/nippo review で自己評価、/nippo insight で深い振り返り、 /nippo trend で長期変化分析、/nippo plan で朝の行動実験、 /nippo ledger で詰まりの累積集計と収束/発散判定を生成する。 Rust バイナリ (nippo) でデータを収集する。
allowed-tools
Read, Write, Glob, Bash(nippo *), Bash(cargo run -q -p nippo *), Bash(mkdir -p reports), Bash(mkdir -p tmp), Bash(rm -f tmp/nippo-raw.json), Bash(gh issue list *), Bash(gh issue create *)
argument-hint
[mode] [days|period] [project] [source]
context
fork

指示

$ARGUMENTS に基づいてモードと収集条件を決め、必要なデータだけを収集してレポートを生成する。

ルール

  • データ収集は nippo CLI のみ。Python は絶対に使わない(python, python3, python -c すべて禁止)
  • stats の集計済みデータは直接引用する。再計算しない
  • 書籍・URL は紹介しない。概念名・検索キーワードを示す
  • レポートは日本語で出力する
  • 出力先は cwd の reports/ 配下(なければ mkdir -p reports)
  • ファイル名: reports/{モード}-YYYY-MM-DD.md(期間 N>1 なら -Nd を付与)
  • 日付境界は実行環境のローカルタイムゾーン基準。--days 1 と daily は「今日のローカル日付」を意味する
  • デフォルト source は auto。Codex では history.jsonl と state_5.sqlite、および rollout_path が指す rollout データを使う。logs_2.sqlite は診断用で、日報の主データソースにはしない
  • Codex は history.jsonl にないセッションも、SQLite が参照する rollout に対象期間内のユーザー発言があれば収集する。history ファイル自体がなくても利用でき、重複する発言はコレクターが統合する
  • このリポジトリ内で実行している場合は、グローバル nippo より cargo run -q -p nippo -- collect ... を優先する(ローカル実装が新しい可能性があるため)
  • モードと引数を決める前にデータを先読みしない。同じ条件の収集は 1 回だけ実行する
  • 収集 JSON の一時ファイル tmp/nippo-raw.json はレポート保存後に必ず削除する。収集や生成に失敗して停止する場合も削除する
  • コレクターは定型的なプロンプトノイズを既定で除外する。レポート生成では --include-prompt-noise を付けない
  • 日報モードでは、このターンで取得した JSON を唯一の根拠にする。既存の reports/nippo-YYYY-MM-DD.md は読まないし、続きから直さない
  • 日報のヘッダと統計は meta と stats をそのまま使う。meta.source meta.period meta.total_sessions stats.projects_worked_on stats.tool_frequency を推測で置き換えない
  • 対象期間を記載する全モードで meta.period.from と meta.period.to を使い、実行日から日付を計算し直さない
  • 日報本文のプロジェクト節は stats.projects_worked_on の順(message_count 降順)で選ぶ。上位 3〜5 プロジェクトは必ず個別に触れ、残りだけを その他 にまとめる
  • Codex 由来のレポートは assistant/tool のメトリクスが疎になることがある。数値を捏造せず、疎であることを明示する
  • source の解決やデータ欠損について質問されたら ${CLAUDE_SKILL_DIR}/docs/data-sources.md を Read する
  • decisions を一部だけ載せる場合は「全N件中M件を記載」と明記する
  • 現在の Claude Code / Codex セッションはコレクターが除外するため、meta や stats から手作業でセッション数を引かない
  • 参考リンクの URL はそのまま貼らず、末尾の日本語や句読点を落として正しい URL だけを残す

モード決定

$ARGUMENTS をトリミングし、先頭単語でモードを決定する:

先頭単語モードデフォルト期間収集コマンド
(空)日報1日nippo collect --period today
daily日報1日nippo collect --period today
briefbrief1日nippo collect --period today --format summary(そのまま保存)
reflectionreflection1日nippo collect --period today
guideguide1日nippo collect --period today
reportreport7日nippo collect --days 7 --stats-only
reviewreview90日nippo collect --days 90 --stats-only
insightinsight7日nippo collect --days 7
trendtrend90日期間を3等分し、区間ごとに nippo collect --from X --to Y --format summary を3回
planplanなし(最新の日報)収集なし。reports/ の既存ファイルを Read
ledgerledgerなし(reports/nippo-*.md)nippo ledger(collect は実行しない)
(数値のみ)日報その数値nippo collect --days N

daily は (空) と同じ日報モードのエイリアス。出力ファイル名は reports/nippo-YYYY-MM-DD.md を使う。

残りトークンのうち claude / codex / opencode / all は --source に渡す。today / yesterday / this-week / last-week / week-before-last / this-month / last-month / month-before-last は --period に渡す。この場合、モード既定の --days や --period today は付けない(明示された --period が唯一の期間指定になる)。数値があれば --days を置換。それ以外の文字列は --project に渡す。先頭単語がモード名・数値・source・period のいずれでもない場合は日報モードとして扱い、その単語を --project に渡す。

--period を指定して daily を実行する場合、出力ファイル名の日付は collector が返す meta.period.to を使う。実行日から計算し直さない。

Show full SKILL.md (209 more words)Show less

収集と生成

plan モードは収集を行わない。Glob で cwd の reports/nippo-*.md を探し、 ファイル名の日付が最新のものを Read する。reports/ledger.yaml が存在すればそれも Read し、最近も再出現している未収束の General Fix Rule を候補材料にする。 ${CLAUDE_SKILL_DIR}/docs/templates/plan-template.md と ${CLAUDE_SKILL_DIR}/docs/reflection-theory.md を Read し、候補を 1〜3 個だけ提示する。 選ぶ実験・理由・最初の一手の記入欄は空白のまま reports/plan-YYYY-MM-DD.md に保存し、パスを通知して完了。

ledger モードは収集・テンプレートを使わない。このリポジトリ内なら cargo run -q -p nippo -- ledger、それ以外は nippo ledger を実行する。cwd の reports/nippo-*.md から ## Unclear points セクションを横断パースして reports/ledger.yaml に累積し、CONVERGED / DIVERGENCE-SIGNAL / CONTINUE の判定を出力する。この判定はそのままユーザーに伝え、過剰に解釈しない。利用者が agent 設定向けの候補を求めた場合は ledger --export を実行する。複数回出現した General Fix Rule が reports/ledger-export.md に出力されるが、候補にすぎないため、CLAUDE.md / AGENTS.md へコピーする前に人間が取捨選択すると伝える。以上で完了。

その他のモード:

  1. mkdir -p tmp を実行する。このリポジトリ内なら cargo run -q -p nippo -- collect ...、それ以外は nippo collect ... を Bash で 1 回実行し、JSON を tmp/nippo-raw.json にリダイレクトする(brief はリダイレクトせず出力を直接保存して完了)
  2. tmp/nippo-raw.json を Read で読み込む。大きい場合は分割して読み、途中で切れた Bash 出力から JSON を推測しない
  3. モードに対応するテンプレートを Read で読み込む

テンプレートは ${CLAUDE_SKILL_DIR}/docs/templates/ にある:

モードテンプレートファイル補足
日報${CLAUDE_SKILL_DIR}/docs/templates/nippo-template.md用語レビュー含む
reflection${CLAUDE_SKILL_DIR}/docs/templates/reflection-template.md回答は書かない
guide${CLAUDE_SKILL_DIR}/docs/templates/guide-template.md回答 + 概念 + 多角的フィードバック
report${CLAUDE_SKILL_DIR}/docs/templates/report-template.md成果 + 課題。感情は含めない
review${CLAUDE_SKILL_DIR}/docs/templates/review-template.md成果の定量化 + 成長 + 次期目標
insight${CLAUDE_SKILL_DIR}/docs/templates/insight-template.mdALACT モデルで回答付き
trend${CLAUDE_SKILL_DIR}/docs/templates/trend-template.md3期間の比較。最低45日
plan${CLAUDE_SKILL_DIR}/docs/templates/plan-template.md候補のみ提示。選択と記入は利用者

reflection / guide / insight / plan は ${CLAUDE_SKILL_DIR}/docs/reflection-theory.md も Read する。 reflection / guide は同日の reports/nippo-YYYY-MM-DD.md があれば Read する。

  1. テンプレートに従いレポートを Write で保存(日報モードは既存ファイルがあっても上書き)
  2. rm -f tmp/nippo-raw.json で収集 JSON を削除する
  3. パスとレポートの要点を簡潔に通知する。改善提案は後述の条件を満たす場合だけ続ける
  4. 日報(Unclear points セクションを含む)を生成した後は、/nippo ledger で詰まりを累積集計できることを一言案内する(自動では実行しない)

改善提案と Issue 作成

レポート生成中に、同じ決定的な集計・整形をモデルが繰り返し担う不足や、複数モードへ影響する構造的な問題を見つけた場合は Issue を提案できる。個別の不足をばらばらに起票せず、同じ原因から生じる症状は一つの課題としてまとめる。1 回のレポート生成で提案するのは最大 2 件とする。

次は既存データから直接わかるため、改善候補にしない:

  • プロジェクト総数: stats.projects_worked_on の要素数
  • 対象期間: meta.period
  • 上位ツールと主要時間帯: render_helpers
  • テンプレート内だけで完結する文章表現や要約

提案前に gh issue list --repo nwiizo/nippo --state all で重複を確認する。既存 Issue で扱われている場合や、既存フィールドの読み方を直せば済む場合は提案しない。新しい Issue が必要な場合は、確認できた事実、影響するモード、共通の原因、解決後に省ける処理をまとめたタイトルと本文案をユーザーに示し、明示的な了承を得てから gh issue create --repo nwiizo/nippo を実行する。

© nwiizo, 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 .claude/skills/nippo of nwiizo/nippo.

  • SKILL.md
  • docs

Open the folder on GitHubat commit cdd521d

Compare with similar skills

Nippo Daily Report Generator 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.

Nippo Daily Report Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nippo Daily Report Generator this skillnwiizo/nippo180—~1.7kAutomated safety check: PassMIT
Daily Standup and Journaliflytek/skillhub5.2k—~1.9kAutomated safety check: PassMIT
Engineering RetroMathews-Tom/armory328—~2.3kAutomated safety check: PassMIT
Waku Computer Useegoist/waku1.6k—~3.6kAutomated safety check: PassGPL-3.0
Linux Desktop Controlagent-sh/computer-use-linux669—~2.8kAutomated safety check: PassMIT
Daily Journalravila4/claude-adhd-skills157—~2.5kAutomated safety check: PassMIT

Similar skills

  • Produces short daily standups, evening reflections and weekly retrospectives for one person or a small team, kept in the session unless you name a place to save.

    5.2k GitHub stars~1.9k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Engineering Retro

    Mathews-Tom/armory

    Git-based engineering retrospective analyzing commits, PRs, and velocity over configurable windows with monorepo path scoping.

    328 GitHub stars~2.3k tokensUpdated 4 days ago
    Product & Project ManagementAuto-check passed
  • Control local macOS, Windows, and Linux apps through Waku Computer Use.

    1.6k GitHub stars~3.6k tokensUpdated 7 days ago
    Productivity & AutomationAuto-check passed
  • Linux Desktop Control

    agent-sh/computer-use-linux

    Lets an agent observe and operate a local Linux desktop through the computer-use-linux MCP server or Pi tools: accessibility trees, screenshots, windows and input.

    669 GitHub stars~2.8k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Daily Journal

    ravila4/claude-adhd-skills

    Draft, organize, or update development journal entries. An agent skill from ravila4/claude-adhd-skills.

    157 GitHub stars~2.5k tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check passed
  • Gsd Browser

    gsd-build/gsd-browser

    Native Rust browser automation CLI for AI agents. An agent skill from gsd-build/gsd-browser.

    268 GitHub stars~1.3k tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed

More from nwiizo/nippo

  • Turns recent Claude Code, Codex or opencode work into Japanese daily reports, reflections, reviews and trend summaries saved in a reports folder.

    180 GitHub stars~2.3k tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Nippo Daily Report Generator

What does Nippo Daily Report Generator do?

Generates daily reports, reflections, weekly reports, self-reviews and trend insights, in Japanese, from Claude Code, Codex and opencode session logs using the nippo CLI. md is in Japanese. The first word of the arguments picks a mode: daily (the default), brief, reflection, guide, report, review, insight, trend, plan or ledger.

When should I use Nippo Daily Report Generator?

Nippo Daily Report Generator fits situations like: writing a daily work report from today's agent sessions; preparing a weekly progress report from recent session logs; doing a longer self-review or trend analysis of how your work changed; generating reflection questions or a morning action plan from past work.

How do I install Nippo Daily Report Generator in Claude Code?

Run `npx skills add nwiizo/nippo --skill nippo -a claude-code`. Or copy the skill folder (.claude/skills/nippo in nwiizo/nippo) into .claude/skills/nippo in your project. Claude Code loads it when a task matches its description.

How do I install Nippo Daily Report Generator in Codex?

Run `npx skills add nwiizo/nippo --skill nippo -a codex`. Or copy the skill folder (.claude/skills/nippo in nwiizo/nippo) into .agents/skills/nippo in your project. Codex loads it when a task matches its description.

Can I use Nippo Daily Report Generator 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 nwiizo/nippo --skill nippo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nippo, .gemini/skills/nippo, .github/skills/nippo and .opencode/skills/nippo in your project.

What does Nippo Daily Report Generator need to run?

Going by SKILL.md and its folder, Nippo Daily Report Generator needs the command-line tools its instructions call (cargo and gh). Our summary lists: The nippo CLI, or cargo to run it from the repository; Session logs from Claude Code, Codex or opencode. Its frontmatter pre-approves these tools: Read, Write, Glob, Bash(nippo *), Bash(cargo run -q -p nippo *), Bash(mkdir -p reports), Bash(mkdir -p tmp), Bash(rm -f tmp/nippo-raw.json), Bash(gh issue list *), Bash(gh issue create *).

Does Nippo Daily Report Generator access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Nippo Daily Report Generator 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 Nippo Daily Report Generator use?

Nippo Daily Report Generator 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 Nippo Daily Report Generator use?

About 1.7k tokens (SKILL.md is roughly 6.7k 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 Nippo Daily Report Generator?

Skills that share tags, products or a category with Nippo Daily Report Generator: Daily Standup and Journal (iflytek/skillhub, 5.2k stars), Engineering Retro (Mathews-Tom/armory, 328 stars), Waku Computer Use (egoist/waku, 1.6k stars) and Linux Desktop Control (agent-sh/computer-use-linux, 669 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nippo Daily Report Generator?

nwiizo (a GitHub user) maintains it in nwiizo/nippo, which has 180 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 1, 2026.

Source: nwiizo/nippo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.