agentleFS
xcrrrxcrrr/claude-skills/skills/productivity/journaling/SKILL.md

journaling

Skill6 starsChanged 8 months agoMITView on GitHub

Use this skill when writing journal entries, generating reflection prompts, or reviewing a period of time through structured writing. Trigger phrases: 'help me journal about', 'journal prompts for', 'reflect on my week', 'write a journal entry'. Do NOT use for formal therapy or clinical mental health intervention.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈12

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Prompted reflection: When you want depth on a specific topic but need questions to guide you past surface-level answers.

    line 46
  2. Distinctive:

    Future-self letter: Write a letter to yourself 1, 5, or 10 years from now.

    line 49
  3. Distinctive:

    Extract the insight: Before closing an entry, write one sentence that captures the core insight or takeaway.

    line 60
  4. Distinctive:

    Shipped the feature: after 3 weeks of work — this is a genuine win.

    line 79
  5. Distinctive:

    Put gym sessions on the calendar as non-negotiable blocks (Tuesday, Thursday, Saturday, 7 AM)

    line 98
  6. Distinctive:

    Write by hand when possible—research suggests handwriting produces more reflective, less performative writing than typing

    line 164
  7. Distinctive:

    Don't edit while writing; the internal critic kills authentic reflection—edit only for extraction, not quality

    line 165
  8. Distinctive:

    Keep your journal private—entries written for an audience (even imagined) are less honest

    line 167
  9. Distinctive:

    Use the same opening ritual each time (same song, same cup of tea, same opening sentence) to reduce friction

    line 169
  10. Distinctive:

    Using journaling as rumination: If you write the same worry 10 days in a row without moving to "so what / now what," the journal is …

    line 175
  11. Distinctive:

    Use a consistent notebook or app — switching tools constantly breaks the habit and loses the archive

    line 181
  12. Distinctive:

    Keep a "quotes and ideas" section alongside personal entries for things that resonated — links your inner life to external inputs

    line 184

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Journaling

Overview

This skill guides personal reflection through structured journaling—whether you need a blank-page prompt to start, a framework to process a difficult experience, a weekly review template, or a full journal entry written as a thinking partner. Journaling formats covered include gratitude journaling, stream-of-consciousness free writing, structured weekly/monthly reviews, decision journals, and future-self letters. The output is either a prompt set, a filled-in journal entry, or a reflection framework tailored to your situation.

When to Use

  • Starting a journaling habit with guided prompts
  • Processing a difficult decision, event, or emotion through writing
  • Conducting a structured weekly or monthly review
  • Gaining clarity on a goal, relationship, or recurring problem
  • Writing a future-self letter or year-in-review entry
  • Maintaining a decision journal to improve future judgment

When NOT to Use

  • Clinical mental health intervention or trauma processing (seek a licensed therapist)
  • Formal documentation or legal records
  • Creative fiction writing (use storyteller skill instead)
  • Public-facing writing such as blog posts or essays

Quick Reference

TaskApproach
Daily journaling3 prompts: gratitude + intention + reflection on yesterday
Weekly reviewWhat went well → what didn't → key learning → next week's focus
Processing an eventDescribe → feel → interpret → extract → next action
Decision journalContext → options considered → final decision → reasoning → revisit date
Future-self letterAddress future self, describe current state, articulate hopes, set accountability
Stuck/blank pageStart with "Right now I feel…" and write for 5 minutes without stopping
Recurring problemWrite the problem, ask "why" five times (5 Whys), identify root cause

Instructions

  1. Identify the journaling purpose. Different purposes require different structures. Processing a difficult emotion calls for free-writing prompts; a weekly review needs a structured template; a decision journal needs a consistent schema. Clarify the goal before choosing the format.
  2. Choose the right format. The five core formats and when to use them:
    • Free writing: Emotional processing, creative thinking, clearing mental clutter. No rules—write continuously for a set time.
    • Prompted reflection: When you want depth on a specific topic but need questions to guide you past surface-level answers.
    • Structured review (weekly/monthly/yearly): Systematic look backward and forward; best for tracking growth over time.
    • Decision journal: Capture the context and reasoning of a significant decision now, revisit it later to calibrate judgment.
    • Future-self letter: Write a letter to yourself 1, 5, or 10 years from now; clarifies values and long-term priorities.
  3. Set the container. Journaling works best with a defined constraint: a time limit (10 minutes), a page limit (one page), or a prompt count (three questions). Open-ended journaling often leads to avoidance. Constraints reduce the blank-page problem.
  4. Start with what's true right now. The most effective journal entries begin with present-moment honesty: "Right now I feel…", "This week the thing I can't stop thinking about is…", "If I'm being honest with myself…". This cuts through performance and surfaces authentic material.
  5. Ask layered questions. Surface prompts produce surface answers. Move from description → interpretation → implication:
    • Layer 1 (What): "What happened?"
    • Layer 2 (So what): "What does this mean to me? Why did this bother/delight me?"
    • Layer 3 (Now what): "What do I want to do differently? What do I want to keep doing?"
  6. Extract the insight. Before closing an entry, write one sentence that captures the core insight or takeaway. This anchors the reflection as a usable thought rather than just an emotional release. Label it: Insight: or Key learning:
  7. Connect to action (when appropriate). For goal-oriented journaling, each entry should end with one concrete next action, even if small: "I will send that email." "I will tell her how I feel this week." "I will block Tuesday morning for deep work." This bridges reflection and behavior change.
  8. Create a consistent ritual. Journaling works best as a habit, not a crisis tool. The same time, same space, same opening move (e.g., "I always start with three things I'm grateful for") builds the automatic trigger that makes the practice sustainable.

Examples

Example 1: Weekly Review Journal Entry

Input: "Help me do a weekly review. It's Sunday. This week I shipped a feature I've been working on for 3 weeks, had a frustrating argument with my co-founder, didn't exercise at all (planned to go to the gym 3x), and felt really proud when a user emailed to say our product changed their workflow."

Output:


Weekly Review — [Sunday's Date]

What Went Well This Week
  • Shipped the feature after 3 weeks of work — this is a genuine win. It's done and out in the world. Pause and feel that.
  • User email about workflow change — this is exactly why we're building this. This is the mission made real. Save this email; read it when things feel hard.
What Didn't Go as Planned
  • Exercise: 0/3 gym sessions. I had the intention but not the system. This wasn't a motivation failure—it was a scheduling failure. The gym wasn't on my calendar; features were.
  • Co-founder argument: Frustrating in the moment. But I haven't fully unpacked what the argument was really about. (See prompt below.)
Deeper Reflection: The Co-founder Argument

What was the argument actually about? On the surface, a disagreement about the product roadmap. But underneath, I think it was about control and not feeling heard. I made a unilateral decision about a feature priority and didn't loop them in early enough.

What does this mean? I'm operating more independently than our partnership structure supports right now. That gap will widen if I don't address it.

What do I want to do differently? Set a 30-minute weekly sync with my co-founder specifically for roadmap alignment. This week.

Key Learning

Insight: Shipping feels good, but shipping without alignment creates friction downstream. Communication is part of the work, not separate from it.

Next Week's Focus
  1. Schedule and have a direct conversation about the roadmap disagreement — don't let it calcify
  2. Put gym sessions on the calendar as non-negotiable blocks (Tuesday, Thursday, Saturday, 7 AM)
  3. Reply to the user who emailed — a personal response means more than they'll expect
One Thing I Want to Remember from This Week

That user email. Real people. Real impact. That's what this is for.


Example 2: Journal Prompts for Processing a Difficult Decision

Input: "I'm trying to decide whether to quit my stable job and go full-time on my startup. I keep going in circles. Give me journal prompts to think this through."

Output:


Decision Journal Prompts: Career Transition

Work through these prompts in order over 2–3 sessions. Write for at least 5 minutes per prompt without editing yourself.


Session 1: Clarifying the Decision

Prompt 1 — The Honest Ledger

Write out, uncensored, every reason you want to quit your job. Then write every reason you want to stay. Don't try to balance them—just get them all out. Which list was easier to write? Which one surprised you?

Prompt 2 — The Regret Minimization Test (Jeff Bezos's framework)

Imagine you are 80 years old, looking back on your life. You stayed at your job. How do you feel about that choice? Now imagine you quit and tried the startup—and it failed. How do you feel about that choice? Which regret is heavier?

Prompt 3 — The Fear vs. Excitement Inventory

Make two columns: "I'm afraid that…" and "I'm excited about…". Fill each until you run out. Now look at the fear column—how many of those fears are likely, and how many are catastrophic but improbable?


Session 2: Testing Your Assumptions

Prompt 4 — The Reversibility Test

If you quit and it doesn't work after 12 months, what happens? Write out the realistic worst case. How permanent is this decision really?

Prompt 5 — The Advisor Chair

Imagine the wisest person you know is sitting across from you. You describe your situation. What do they ask you? What do they tell you? Write that conversation out.

Prompt 6 — The "Not Deciding" Trap

You've been circling this decision. Write about what not deciding is costing you right now—energy, focus, sleep, relationships, performance at work. Is staying in limbo actually the safe choice?


Session 3: Committing and Planning

Prompt 7 — The Conditions

What would need to be true for you to feel ready to make either choice confidently? Are those conditions achievable, or are they a way of deferring forever?

Prompt 8 — Letter to Future Self

Write a letter to yourself, 2 years from now, telling them what you decided and why. What do you want future-you to know about who you were when you made this choice?

Prompt 9 — The First Step

Whatever direction you're leaning, what is one concrete action you could take this week that moves you toward clarity or commitment? Write that action down and put it on your calendar.


After all three sessions: Reread your entries. You will likely find that you already know the answer. Journaling doesn't create clarity—it reveals the clarity that was already there beneath the noise.


Best Practices

  • Write by hand when possible—research suggests handwriting produces more reflective, less performative writing than typing
  • Don't edit while writing; the internal critic kills authentic reflection—edit only for extraction, not quality
  • Date every entry; patterns are invisible until you can look back across weeks and months
  • Keep your journal private—entries written for an audience (even imagined) are less honest
  • Revisit decision journal entries 6–12 months later; the gap between predicted and actual outcomes calibrates judgment
  • Use the same opening ritual each time (same song, same cup of tea, same opening sentence) to reduce friction

Common Mistakes

  • Waiting for the perfect mood: Journaling when you feel fine produces useful baseline data; journaling when you feel bad produces insight—both are valuable
  • Summarizing instead of reflecting: "I had a busy week" is a summary; "I felt anxious all week and I don't know why" is a reflection worth exploring
  • Skipping the insight extraction: Free writing without capturing a takeaway is emotional release without learning
  • Using journaling as rumination: If you write the same worry 10 days in a row without moving to "so what / now what," the journal is amplifying rather than processing
  • All gratitude, no honesty: Gratitude journaling is valuable, but a journal that only captures positives fails at self-knowledge
  • Abandoning after missing a few days: Consistency matters, but "I missed a week" is not a reason to stop—just start again

Tips & Tricks

  • The "morning pages" technique (Julia Cameron): 3 pages of longhand stream-of-consciousness immediately on waking, before any input — clears mental cache
  • Use a consistent notebook or app — switching tools constantly breaks the habit and loses the archive
  • A 5-minute "micro journal" (one sentence of gratitude + one intention) is better than no journaling on busy days
  • For emotional processing, try writing in the third person ("She felt frustrated when…") — research shows this creates therapeutic distance and clarity
  • Keep a "quotes and ideas" section alongside personal entries for things that resonated — links your inner life to external inputs
  • Set a phone reminder labeled "What happened today worth remembering?" — it prompts reflection before the day is gone

Related Skills

  • note-taker
  • habit-builder
  • decision-maker
  • storyteller

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.