MCPInstall

journal-reflection

Guide Ane through structured reflection at end of day, end of week, after a decision, or after new learning material, producing Obsidian-compatible markdown and writing to the vault journal when the path is reachable. Use on 'journal', 'reflect on today', 'weekly review', 'after-action review', or asks that reference writing to the Obsidian vault. For a quick 4-line post-deliverable capture use /learned instead.

Installs
717
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/gasserane/personal-skills --skill journal-reflection
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads journal-reflection automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Journal Reflection

Structured reflection without the usual journaling bloat. Four modes. Pick one and run it tight.

When to use

Trigger when the user asks to reflect, review, or capture learning. Not for morning briefings — route to daily-brief for that.

Mode selection

Ask once, in one prompt, which mode applies. Default to end-of-day if the user says "journal" without specifying.

  1. End-of-day (5 min): today in 3 questions
  2. End-of-week (15 min): week in 5 questions plus a pattern scan
  3. Decision review: one past decision in 4 questions
  4. Learning log: one new framework or concept, linked to what Ane already knows
  5. Post-deliverable capture (2 min): the 4-line "what did I learn" after finishing a deliverable, appended to a running log. Lighter than mode 4 (no framework deep-dive); deliverable-triggered, not concept-triggered. /wrap-up offers this at session end; Ane can also trigger it directly any time.

Prompts by mode

End-of-day

Ask these three, one at a time, waiting for each answer:

  1. What got done today that mattered? (not a task list — what moved)
  2. What got in the way, and what did it cost?
  3. What does tomorrow need from you that today did not get?

Close with: one commitment for tomorrow, one sentence, verb-first.

End-of-week

Ask these five, one at a time:

  1. Against this week's stated goals, what is the honest progress? (percentage-free language)
  2. What patterns showed up this week that also showed up last week?
  3. What did you learn about the work, or about yourself doing the work?
  4. What will you change next week? Specific, small, testable.
  5. What deserves to be named as a win that you have not named yet?

Close with: one pattern-to-watch next week.

Decision review

Ask:

  1. What was the decision, and when did you make it?
  2. What did you know at the time, and what were you guessing?
  3. What happened in the days or weeks since?
  4. What would you do differently if the decision arrived today?

Close with: one rule to carry forward, written as an if-then.

Learning log

Ask:

  1. What is the concept or framework? Cite author and year if it has one.
  2. What problem does it solve that older frameworks do not?
  3. How does it connect to something Ane already uses?
  4. Where will Ane apply it first?

Post-deliverable capture

Ask these four, one at a time. Keep each answer to one line; this is a fast capture, not a full reflection.

  1. What did this deliverable teach you about the work?
  2. What would you do differently next time?
  3. One thing to carry forward.
  4. What worked that you want repeated? (success extraction)

If answer 4 names a repeatable system behaviour (a prompt pattern, a workflow, a specialist or model choice), offer to also bank it as a feedback memory with Why: and How to apply: lines — one yes/no, no push. This gives /improve-system confirmed successes to trend, not only corrections.

If Ane gives the deliverable a name or slug, use it; otherwise ask for a 2–4 word label. This mode appends to a single running log (see File placement) rather than creating one file per entry.

Output format

Write Obsidian-compatible markdown with YAML frontmatter:

---
date: YYYY-MM-DD
type: [daily | weekly | decision-review | learning-log]
tags: [journal, ...domain tags]
dg-publish: false
---

Use [[wiki-links]] for people, concepts, frameworks, and projects. Default dg-publish to false. If the user says the note is publishable, set to true and ask for the permalink stub.

Body structure: one H2 per prompt, the answer as plain prose under it, no bullets unless the content is a list.

File placement

Vault root: OBSIDIAN_VAULT_ROOT (C:/Users/AGasser/OneDrive/Ane Obsidian Vault — see the path constants table in ~/.claude/CLAUDE.md). If the vault path is reachable, write directly with the Write tool:

  • End-of-day: 5 JURNAL/5a Daily Notes/YYYY-MM-DD.md
  • End-of-week: 5 JURNAL/5b Weekly Notes/YYYY-Www.md
  • Decision review: 5 JURNAL/Decisions/YYYY-MM-DD-<slug>.md
  • Learning log: 5 JURNAL/Learning/<slug>.md
  • Post-deliverable capture: append to 5 JURNAL/Learning/deliverable-learning-log.md (single running log). If the file does not exist, create it with the YAML frontmatter (type: learning-log) and an H1, then add the first entry. If it exists, append a new ## YYYY-MM-DD — <deliverable label> section with the four answers as bullets, preserving all prior entries byte-identical (edit-preservation).

If the vault path is not reachable (web session, other device), return the markdown in the reply and name the target path so the user can save it manually.

Writing rules

Follow CLAUDE.md house style. One exception: in journal answers, passive and reflective phrasing is acceptable when Ane's answer is itself reflective. Do not rewrite her words into active voice — preserve her voice exactly.

Limitations

Do not invent reflections. Do not auto-answer the prompts. Prompts go to the user and wait. If the user skips a prompt, mark the section (skipped) and move on. Do not lecture.

Edit-preservation protocol

If Ane references an existing output by path and asks to improve, iterate, or expand it, the protocol activates. Read the file first, edit scope-bounded via the Edit tool, preserve out-of-scope content byte-identical, and return the EDIT-PRESERVATION DELIVERY summary.

Apply mel_wiki/wiki/concepts/edit-preservation-protocol.md when target file exists.

FAQ

What does the journal-reflection skill do?

Guide Ane through structured reflection at end of day, end of week, after a decision, or after new learning material, producing Obsidian-compatible markdown and writing to the vault journal when the path is reachable. Use on 'journal', 'reflect on today', 'weekly review', 'after-action review', or asks that reference writing to the Obsidian vault. For a quick 4-line post-deliverable capture use /learned instead.

How do I install journal-reflection?

Run npx skills add https://github.com/gasserane/personal-skills --skill journal-reflection in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/journal-reflection/ (personal) or .claude/skills/journal-reflection/ (project).

Which AI agents can use journal-reflection?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is journal-reflection safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains journal-reflection?

It is published by gasserane in gasserane/personal-skills. It has 717 recorded installs.

More from gasserane/personal-skills

View all →

evidence-synthesis

gasserane/personal-skills

Conduct a rigorous rapid evidence assessment or systematic-lite literature review for MEL/SRHR questions. Use when Ane asks for "evidence review", "literature review", "evidence synthesis", "REA", "what does the evidence say", "what do we know about", or similar. Produces a structured brief with question framing, method, findings by theme, confidence grading, and implications for programme or evaluation design. Does not invent citations.

daily-brief

gasserane/personal-skills

Produce a scannable morning briefing for Ane (Senior MEL/SRHR Specialist at IPPF). Use when the user asks for "daily brief", "morning briefing", "start of day", "what's on today", "plan my day", or similar. Assembles today's priority, calendar, overdue items, pending decisions, and an energy check. Operates on user-provided inputs by default; richer when calendar/email MCP servers are connected.

decision-memo

gasserane/personal-skills

Draft a structured decision memo for Ane. Use when the user asks for a "decision memo", "decision doc", "options paper", "recommendation brief", or equivalent. Produces a scannable document with context, options, recommendation, risks, and reversibility. Applies Ane's CLAUDE.md writing style automatically.

Docs & Writing664 installs

video-content-analysis

gasserane/personal-skills

Convert FGD/webinar/SBCC video files into a structured artefact pack (transcript, frames, manifest, Tier 1 BLUF summary) the existing MEL specialists can consume. Use when Ane asks to "analyse a video", "transcribe a focus group", "process a webinar recording", "summarise a meeting recording", or runs /analyze-video . Tiered transcription (local Whisper for sensitive; M365 Stream for internal/public). Privacy + consent validated by construction. Per-run feedback prompt feeds the self-improvement loop.

Media & Creative662 installs

power-bi-build

gasserane/personal-skills

Build IPPF-branded Power BI artefacts from analytical input. Use when Ane asks to build, scaffold, or update a Power BI dashboard, semantic model, DAX measures, or .pbip project. Applies IPPF Visual Identity 2025 brand, MEL-standard DAX measures, and three standard page recipes (indicator dashboard, equity disaggregation, methodology card). Requires the pbi CLI (pbi-cli-tool, command name pbi) installed and Power BI Desktop running with a .pbip open.

Data & Databases658 installs

indicator-designer

gasserane/personal-skills

Design MEL/SRHR indicators to IPPF/UNFPA/UNAIDS publication standard. Use when Ane asks for "indicators", "KPIs", "results framework", "M&E indicators", "measurement framework", or equivalent. Enforces WHO (2010) WHO/RHR/10.12 standards plus Washington Group disaggregation, applies Tier 1/2/3 integrity markers, defines measurement mechanisms, and flags data gaps. Distinguishes output, outcome, and impact indicators precisely.

Frontend & Design656 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs