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

Planning with Files

Manus-style persistent planning that keeps task_plan.md, findings.md, and progress.md on disk so work survives /clear and context compaction.

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

What it does

  • Creates three markdown files in your project root — task_plan.md (phases and status), findings.md (research), progress.md (session log) — treating the filesystem as durable working memory instead of the context window.
  • Hooks on UserPromptSubmit, PreToolUse, and PreCompact re-inject the active plan, and a PostToolUse hook nudges you to log what just changed. session-catchup.py restores state after /clear or compaction.
  • Encodes operating rules: plan before acting, save findings after every 2 view/search operations, a 3-strike error protocol that escalates to the user, plus a read-vs-write decision matrix and anti-pattern table.

Who it's for

  • Developers running long tasks (refactors, migrations, multi-service changes) that take dozens of tool calls.
  • Anyone who keeps losing the thread after /clear or a dropped session.
  • Researchers who repeatedly re-search information they already read.

Examples

  1. Large refactor: ask to "migrate auth to JWT" and it drafts a 5-phase task_plan.md, flips each phase to complete, and logs every error with its resolution.
  2. Tech evaluation: while skimming several library docs, it flushes key notes to findings.md every couple of lookups so the comparison survives context loss.
  3. Session resume: run session-catchup.py with git diff --stat to detect unsynced changes, refresh the planning files, then continue from the next phase.

· · · 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 .mastracode/skills/planning-with-files folder from the GitHub repo OthmanAdi/planning-with-files into my ~/.claude/skills/othmanadi-planning-with-files-9/.
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 && mkdir -p ~/.claude/skills && cp -r planning-with-files/.mastracode/skills/planning-with-files ~/.claude/skills/

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

  1. Open a terminal and change into a folder where you keep source code.
  2. Clone the repo: git clone https://github.com/OthmanAdi/planning-with-files.git
  3. Copy the skill into place: mkdir -p ~/.claude/skills && cp -r planning-with-files/.mastracode/skills/planning-with-files ~/.claude/skills/
  4. Make the helper scripts executable: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  5. If the hooks cannot find the scripts, add export PWF_SCRIPT_DIR="$HOME/.claude/skills/planning-with-files/scripts" to your shell profile.
  6. Restart Claude Code, open a project, and ask it to "plan this out step by step" — you should see task_plan.md appear in the project root.
  7. On Windows, use Git Bash or PowerShell and copy the folder to %USERPROFILE%\.claude\skills instead.
View source on GitHub ↗License: MIT