Illustrative cover generated by us — see the source repo for real examples.
How to use
- 1
Copy the install prompt
Sign in, then click the black button. One click, done.
- 2
Paste it to your agent
Send it in Claude Code, Codex, Cursor or similar. It installs itself.
- 3
Ask in one sentence
Say what you want, like below, and the agent follows this skill.
/planning-with-files make me: Research or tasks needing 5+ tool callsExample message showing how to invoke it, not a real output.
What you get
- Three planning files kept on disk
- Per-turn re-injection against context loss
- A completion gate before the agent says done
Good fit
- Research or tasks needing 5+ tool calls
Not for
- One-shot questions
- License
- MIT
- Author
- @OthmanAdi
- Source
- OthmanAdi/planning-with-files/skills/planning-with-files · ★ 27,304
Upstream description
Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts.…
Other ways to install
Prefer doing it yourself? These commands do the same as the button.
Read https://skilloop.dev/skills/planning-with-files/install.md and follow the instructions to install the skill.
npx skills add https://github.com/OthmanAdi/planning-with-files/tree/master/skills/planning-with-files -g -a claude-code
npx skills add https://github.com/OthmanAdi/planning-with-files/tree/master/skills/planning-with-files -g -a codex
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/skills/planning-with-files ~/.claude/skills/planning-with-files
Original work by its authors, redistributed under its license. We only link and describe it.
Related skills
Data Report Page
Turn a CSV, Excel or JSON file into a polished visual report page with charts and key takeaways.
Skill Creator
Create, edit and benchmark your own Agent Skills — including evals and description tuning for better triggering.
Brainstorming Before Building
Makes your coding agent clarify intent, requirements and design with you before it writes any code.
Systematic Debugging
A four-phase debugging discipline: find the root cause before proposing fixes, for any bug or failing test.