# journal-reflection

Guides end-of-day, weekly, decision, and learning reviews, then saves the result as Obsidian-ready Markdown when the vault can be reached.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 717 installs · ★ 3
- Author: gasserane
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gasserane/personal-skills/tree/HEAD/skills/journal-reflection/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/journal-reflection

## What it does

This skill runs a focused reflection in one of five modes: daily review, weekly review, decision review, learning log, or a short post-deliverable capture. It asks each question in sequence and waits for the response, so the note is built from the user’s own answers rather than invented content.

The output uses YAML frontmatter, H2 sections, and Obsidian `[[wiki-links]]`. Daily and weekly entries go to `5 JURNAL/5a Daily Notes/YYYY-MM-DD.md` and `5 JURNAL/5b Weekly Notes/YYYY-Www.md`; decisions and learning notes use their own paths. The vault path must be reachable for direct writing. Otherwise, the skill returns the Markdown and the target path for manual saving.

Post-deliverable notes are appended to `5 JURNAL/Learning/deliverable-learning-log.md`, preserving earlier entries. Skipped prompts are marked, and `dg-publish` can be set to true when the note is intended for publication.

## Requirements
- Works with: Obsidian

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill journal-reflection -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/journal-reflection/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/journal-reflection/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill journal-reflection -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/journal-reflection/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill journal-reflection -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/journal-reflection/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gasserane/personal-skills journal-reflection
```

2. **Manually: put the files in place**
- File: `.github/skills/journal-reflection/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill journal-reflection -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gasserane/personal-skills --path skills/journal-reflection
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/journal-reflection/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add gasserane/personal-skills --skill journal-reflection -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gasserane/personal-skills/tree/HEAD/skills/journal-reflection/SKILL.md

## When to use it
- review what moved forward during a day
- scan a week for recurring work patterns
- revisit the assumptions behind a decision
- connect a new framework to existing knowledge
- capture lessons from a completed deliverable

## Example prompts
- Run an end-of-day reflection and save the note to my Obsidian vault.
- Ask me the weekly review questions one at a time, then write the result.
- Capture what I learned from the completed deliverable in the running log.

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4000000 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [teach](https://affpapa.org/en/nevibecode/skills/teach.md) — skill · 862247 installs

From the same set: [gasserane/personal-skills](https://affpapa.org/en/nevibecode/by/gasserane/personal-skills.md) — 13 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md