agentleFS
wernerbattwernerbatt/obsidian-gtd-cli/.claude/skills/systems-review/SKILL.md

systems-review

Skill0 starsChanged 7 months agoMITView on GitHub

Weekly review of all active systems — GTD, Atomic, PQ, Friction Elimination, Intuitive Eating. Walk through each system spec, check adherence, capture learnings, and update specs.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈11

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    One question at a time: Never combine two questions in one message.

    line 20
  2. Distinctive:

    Use concrete, low-friction questions: Ask "Did X happen?" or "How many days did you do Y?" — not "What do you want to do more/less of?" If …

    line 21
  3. Distinctive:

    Capture notes proactively: Don't wait for the user to remind you — take status notes after each system and show them before moving on.

    line 22
  4. Distinctive:

    When the user mentions a concept they can't remember,: search the web before answering from memory.

    line 23
  5. Very specific:

    Read the current state of all system specs using the /obsidian skill:

    line 28
  6. Distinctive:

    Keep it conversational. Don't interrogate — just ask one question at a time and follow the thread.

    line 49
  7. Distinctive:

    Run the resistance map live if needed.

    line 67
  8. Distinctive:

    After discussing each system, append a dated entry to the Review Log section of that system's spec:

    line 74
  9. Distinctive:

    If the user wants to change a routine, tweak a cue, add or remove something — update the spec directly.

    line 83
  10. Distinctive:

    Don't force all five if the user only has energy for a few — prioritise what needs attention

    line 94
  11. Distinctive:

    If a system is running smoothly, a quick "GTD's solid this week, anything to flag?" is enough

    line 95
  12. Distinctive:

    Keep review log entries short and actionable, not essay-length

    line 97

≈ “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

Systems Review

Interactive weekly review of all active systems. Run on Sundays during the 16:00–17:00 review block.

Overview

The systems index lives at References/Systems.md in the vault. Each system has its own spec in References/ with routines, principles, and a review log.

How to Run

This is a conversational skill. Walk through each system one at a time with the user. Don't dump everything at once — ask questions, listen, and capture.

Conversation Rules

  • One question at a time. Never combine two questions in one message.
  • Use concrete, low-friction questions. Ask "Did X happen?" or "How many days did you do Y?" — not "What do you want to do more/less of?" If the user stalls or says "too much friction", rephrase with less abstraction.
  • Capture notes proactively. Don't wait for the user to remind you — take status notes after each system and show them before moving on.
  • When the user mentions a concept they can't remember, search the web before answering from memory.
  • Keep it moving. The review itself is a friction source. If a system is running well, one question is enough — don't force depth where there's nothing to discuss.

Step 1 — Load the specs

Read the current state of all system specs using the /obsidian skill:

# See /obsidian skill for $OBS and $VAULT setup
$OBS vault=$VAULT read path="References/Systems.md"
$OBS vault=$VAULT read path="References/GTD System.md"
$OBS vault=$VAULT read path="References/Atomic System.md"
$OBS vault=$VAULT read path="References/PQ System.md"
$OBS vault=$VAULT read path="References/Friction Elimination.md"
$OBS vault=$VAULT read path="References/Intuitive Eating System.md"

Step 2 — Walk through each system

For each system, ask:

  1. How did it go this week? — Did you follow the routines?
  2. What worked? — Anything to keep or reinforce?
  3. What didn't work? — What got missed and why?
  4. What needs to change? — Any tweaks to the spec?

Keep it conversational. Don't interrogate — just ask one question at a time and follow the thread.

System order

  1. GTD — Start here. Check metrics using the /obsidian skill's Dataview queries (inbox count, overdue, stale projects, context distribution, completed this week). Key questions: inbox at zero? Projects moving? Any stale? Overdue tasks?
  2. Atomic — Morning and evening routines. Key questions: how many days did you do the morning routine? Evening routine? What broke the chain?
  3. PQ — Mindfulness and refreshes. Key questions: did the 08:00/13:00/16:00 happen? Any saboteurs you noticed this week?
  4. Friction Elimination — Resistance mapping. Key questions (use these concrete prompts):
    • "Is there a task you keep seeing and skipping?"
    • "Did anything break or get annoying this week?"
    • "Did something just work this week without effort?" Run the resistance map live if needed. Log any actions taken.
  5. Intuitive Eating — Weekly check-in. Key questions: use the prompts in the spec. How's the relationship with food? Diet mentality creeping in?

Step 3 — Capture to review logs

After discussing each system, append a dated entry to the Review Log section of that system's spec:

### YYYY-MM-DD
- [what was discussed, what changed, what to try next week]

Step 4 — Update specs if needed

If the user wants to change a routine, tweak a cue, add or remove something — update the spec directly. The specs are living documents.

Step 5 — Summary

At the end, give a brief summary:

  • Which systems are running well
  • Which need attention next week
  • Any spec changes made

Tips

  • Don't force all five if the user only has energy for a few — prioritise what needs attention
  • If a system is running smoothly, a quick "GTD's solid this week, anything to flag?" is enough
  • The Friction Elimination review can double as a live coaching session — help the user break down stuck tasks on the spot
  • Keep review log entries short and actionable, not essay-length

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.