Skip to content
Productivity
Skill

/weekly-reflection

A short guided reflection on what energized you, what drained you, and one change for next week. Use when the user wants to reflect on how work *felt*, not what got done — 'reflect on my week', 'what's draining me'. Not for progress-and-goals tracking; use `week-review`.

From plugin
dex
51099 skills28 agents24 commands1 MCP

Claude Code

$ npx -y skills add davekilleen/Dex --skill weekly-reflection --agent claude-code

SKILL.md

weekly-reflection.SKILL.md
name: weekly-reflection
description: "A short guided reflection on what energized you, what drained you, and one change for next week. Use when the user wants to reflect on how work *felt*, not what got done — 'reflect on my week', 'what's draining me'. Not for progress-and-goals tracking; use `week-review`."

Execution mode

Run inline in the current conversation by default, so this work can see what the user has already discussed, decided, or settled this session. Do not fork merely because this skill was selected. Only run in the background when the user explicitly asks for a background run or the host has already obtained a specific background-work approval for this run.

Purpose

Pause for a few minutes and notice the lived experience of the week. This is not a progress report. It helps the user see where their energy went and choose one practical change for the week ahead.

How This Differs from `/week-review`

`/week-review` looks at progress, completed work, goals, and concrete measures. `/weekly-reflection` looks at experience: what felt alive, what felt heavy, and what the user wants to do differently.

The two can be used together, but neither requires the other.

Step 1: Set the Frame

Say:

> Let's take five minutes to notice the week, not score it. I'll ask three short questions, one at a time.

If the user wants an even shorter version, accept one sentence per question.

Step 2: Ask What Energized Them

Ask:

> What gave you energy this week? Think about work, people, pace, or moments that felt worthwhile.

After the answer, reflect back the specific source of energy in one or two sentences. Avoid turning it into advice yet.

Step 3: Ask What Drained Them

Ask:

> What drained you this week? What felt heavier, more frustrating, or more costly than it should have?

Notice whether the drain came from the work itself, unclear expectations, too many switches, a relationship, or lack of recovery. Offer the pattern as a possibility, not a diagnosis.

Step 4: Choose One Change

Ask:

> What is one thing you want to change next week?

Help make the answer small and observable. Prefer a change the user can control.

Examples:

  • Protect one meeting-free morning
  • Ask for the decision before starting the work
  • End the day with ten minutes to close open loops
  • Spend more time on the work that created energy this week

If the user names several changes, ask which single one would make the biggest difference.

Step 5: Save the Reflection

Read `System/user-profile.yaml` and check `journaling.weekly`.

If weekly journaling is enabled

Append the reflection to the current weekly journal under:

`00-Inbox/Journals/YYYY/MM-Month/Weekly/YYYY-Www.md`

Create the file from the existing weekly journal pattern if needed. Never replace an earlier entry.

If weekly journaling is not enabled

Ask whether the user wants the reflection saved. If yes, append it to:

`06-Resources/Reflections/Weekly_Reflections.md`

If they prefer not to save it, leave the reflection in the conversation only.

Use this structure:

## Week YYYY-Www — ending YYYY-MM-DD

**Energized by:**
[User's answer]

**Drained by:**
[User's answer]

**One change for next week:**
[User's answer]

Keep the user's own words where possible.

Step 6: Close Gently

End with a short summary:

> This week, [energy source] gave you something back, while [drain] took more than it should. Next week you're trying [one change].

If the chosen change needs a reminder or task, offer to add it through the normal task flow. Do not create one automatically.

Rules

  • Ask one question at a time
  • Do not grade the week or force a positive lesson
  • Do not turn every feeling into a task
  • Keep the reflection short unless the user wants to go deeper
  • Use absolute dates in the saved entry
  • Append to journal files; never overwrite the user's earlier writing
Read more
@davekilleen
Ships withdex

One personal Dex, built around your work. Keep your priorities, people, meeting notes and tasks in a folder you own. Work with Dex through your AI app to plan the day, prepare for a meeting or follow through on a promise.

51099 skills28 agents1 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
510
Star history of davekilleen/Dex on GitHub, a chart by star-history.com

Other skills on dex.

agent-browser

agent-browser

Browser automation using Vercel's agent-browser CLI. Use when you need to interact with web pages, fill forms, take screenshots,…

@davekilleen@davekilleenInstall Skill
agent-native-architecture

agent-native-architect…

Build applications where agents are first-class citizens. Use this skill when designing autonomous agents, creating MCP tools,…

@davekilleen@davekilleenInstall Skill
andrew-kane-gem-writer

andrew-kane-gem-writer

This skill should be used when writing Ruby gems following Andrew Kane's proven patterns and philosophy. It applies when creating…

@davekilleen@davekilleenInstall Skill
brainstorming

brainstorming

This skill should be used before implementing features, building components, or making changes. It guides exploring user intent,…

@davekilleen@davekilleenInstall Skill
compound-docs

compound-docs

Capture solved problems as categorized documentation with YAML frontmatter for fast lookup

@davekilleen@davekilleenInstall Skill
create-agent-skills

create-agent-skills

Expert guidance for creating, writing, and refining Claude Code Skills. Use when working with SKILL.md files, authoring new…

@davekilleen@davekilleenInstall Skill

More skills from other plugins.

i-have-adhd

i-have-adhd

Shape output for a reader with ADHD: lead with the next action, number multi-step work, restate state across turns, suppress…

@ayghri@ayghriInstall Skill
ab-test-analysis

ab-test-analysis

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop…

@phuryn@phurynInstall Skill
distilly

distilly

Set up the owner profile so a personal agent knows who it works for (first-run setup, \"get to know me\"), or distill colleague,…

Questions about weekly-reflection.

Which coding agents can use weekly-reflection?
weekly-reflection installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.