Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Planning with Files

Keeps task_plan.md, findings.md and progress.md on disk so multi-step work survives context loss and /clear.

AutomationIntermediate★ 26,060⑂ 2,177AI score 8/10Last updated: Aug 9, 2026

What it does

Brings the Manus-style "working memory on disk" pattern to Claude Code. Before any complex task, the agent creates three markdown files in your project root and keeps them updated:

  • task_plan.md — phases, status, key decisions
  • findings.md — research and discoveries (especially volatile multimodal/browser output)
  • progress.md — session log, test results, files touched

It also registers hooks that re-inject the current plan on prompt submit, before tool calls and before context compaction, and nudge you to log progress after every Write/Edit. After /clear, session-catchup.py reconstructs the previous session state.

The doc includes a 3-strike error protocol (escalate to the user after three failed attempts), a read-vs-write decision matrix, a 5-question "reboot test", and an anti-pattern table.

Who it's for

  • Anyone running long refactors, migrations or research spanning dozens of tool calls
  • Users frustrated by agents losing the goal once context fills up or after /clear
  • Teams that want an auditable trail of decisions, findings and failed attempts

Examples

  1. Legacy migration: ask it to plan a TypeScript port; it writes a phased task_plan.md and flips each phase to complete as files land.
  2. Library comparison: after every two searches it flushes key notes to findings.md, so the comparison table survives compaction.
  3. Resuming tomorrow: run the catchup script plus git diff --stat to rebuild state and continue exactly where you stopped.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .opencode/skills/planning-with-files folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/othmanadi-planning-with-files-10/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files && mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/.opencode/skills/planning-with-files ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files
  2. Create the skills folder: mkdir -p ~/.claude/skills
  3. Copy the skill in: cp -r /tmp/planning-with-files/.opencode/skills/planning-with-files ~/.claude/skills/
  4. Make the helper scripts executable: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  5. (Optional) If you installed elsewhere, add export PWF_SCRIPT_DIR=~/.claude/skills/planning-with-files/scripts to your shell profile so the hooks can find the scripts.
  6. Restart Claude Code and try "plan out this task" — you should see task_plan.md appear in your project root.
  7. Because the hooks auto-run shell scripts on prompts and tool calls, skim the files in scripts/ before trusting it in sensitive repos.
View source on GitHub ↗License: MIT