AI for Developers
Agent skill (SKILL.md) Open source MIT 28.1k

Planning with Files

Keeps your agent's plan in a file on disk so it survives long tasks and context resets.

Install

Install
$ /plugin marketplace add OthmanAdi/planning-with-files /plugin install planning-with-files@planning-with-files
Or with the skills CLI
$ npx skills add OthmanAdi/planning-with-files -a claude-code
For every project
$ npx skills add OthmanAdi/planning-with-files -a claude-code -g

Or copy the skill folder into .claude/skills/ (project) or ~/.claude/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a codex
For every project
$ npx skills add OthmanAdi/planning-with-files -a codex -g

Or copy the skill folder into .agents/skills/ (project) or ~/.agents/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a cursor
For every project
$ npx skills add OthmanAdi/planning-with-files -a cursor -g

Or copy the skill folder into .agents/skills/ (project) or ~/.cursor/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a gemini-cli
For every project
$ npx skills add OthmanAdi/planning-with-files -a gemini-cli -g

Or copy the skill folder into .agents/skills/ (project) or ~/.gemini/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a github-copilot
For every project
$ npx skills add OthmanAdi/planning-with-files -a github-copilot -g

Or copy the skill folder into .agents/skills/ (project) or ~/.copilot/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a opencode
For every project
$ npx skills add OthmanAdi/planning-with-files -a opencode -g

Or copy the skill folder into .agents/skills/ (project) or ~/.config/opencode/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a antigravity
For every project
$ npx skills add OthmanAdi/planning-with-files -a antigravity -g

Or copy the skill folder into .agents/skills/ (project) or ~/.gemini/config/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a droid
For every project
$ npx skills add OthmanAdi/planning-with-files -a droid -g

Or copy the skill folder into .agents/skills/ (project) or ~/.factory/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a kiro-cli
For every project
$ npx skills add OthmanAdi/planning-with-files -a kiro-cli -g

Or copy the skill folder into .kiro/skills/ (project) or ~/.kiro/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a openclaw
For every project
$ npx skills add OthmanAdi/planning-with-files -a openclaw -g

Or copy the skill folder into skills/ (project) or ~/.openclaw/skills/ (all projects).

For this project
$ npx skills add OthmanAdi/planning-with-files -a hermes-agent
For every project
$ npx skills add OthmanAdi/planning-with-files -a hermes-agent -g

Or copy the skill folder into .hermes/skills/ (project) or ~/.hermes/skills/ (all projects).

When to use

Use it on multi-step tasks that run past one context window, where the agent keeps losing track of what it already did.

Planning with Files keeps an agent's plan on disk so it survives long tasks. The skill maintains task_plan.md, findings.md and progress.md, and lifecycle hooks inject the relevant planning context on each turn. A plan on disk lasts through /clear, crashes and compaction, so the agent can't quietly forget or ignore it. Automatic recovery reads project files only, and reading local agent session records needs an explicit catch-up mode.

It installs across 60+ agents through the Agent Skills standard, with native plugins for Claude Code, Codex CLI, Qoder CLI, Pi, Hermes Agent and OpenCode. The author reports three out of three blind A/B comparisons in its favor, which is a self-reported test.

Related skills

All skills