weekly-self-review
The personal-reflection sibling of weekly-review. Where weekly-review surveys what the vault accumulated, this skill surveys what the user experienced. Different audience (just the user), different voice (subjective, frank), different goal (personal calibration, not program intelligence).
When to use
- Friday afternoon or Sunday evening end-of-week reflection.
- Periodic recalibration after a stretch of intense work.
- Pre-vacation handoff prep — what's nagging that should be written down.
When NOT to use
- Vault-content weekly synthesis →
weekly-review. - Stakeholder communication →
stakeholder-update-writer. - Decision capture →
decision-memo-writerorquick-capture(decision format).
Reflection prompts
The skill walks the user through 5 standard prompts:
- What worked this week? — moments worth replicating.
- What drained? — patterns worth tweaking.
- What did I learn? — knowledge worth keeping.
- What's nagging? — open loops worth surfacing.
- Where do I want to focus next week? — intentional, not aspirational.
Output structure
# Weekly Self Review — {week ending date}
[5 prompts and responses]
## Action items from this review
- {if any concrete actions emerge}
## Calibration
- Energy/satisfaction: {1-10}
- Trend vs prior weeks: {↑ / ↓ / →}
As the final step, write the note via vault-writer.write_insight to vault/insights/YYYY-MM-DD-self-review.md (the slug self-review keeps these distinct from weekly-review). The reflection is for the user's future self — it only pays off if it lands in the vault.
Acceptance test
SKILL.md describes the 5-prompt structure. Live exercise deferred — the next Friday is the natural fixture.