Directory · Skills

Planning with Files

Agent skill that keeps task_plan.md, findings.md, and progress.md on disk so coding agents can resume after /clear, compaction, or crashes.

★ 27,446 stars · last updated 2026-10-12 · Free, open source · View on GitHub

Best for

• Long-running Claude Code or Codex tasks that span context resets
• Recovering task state after /clear or compaction
• Running parallel tasks with isolated plan directories
• Teams using multiple agents that support the Agent Skills standard

Install

npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g

Our take

MIT licensed, actively maintained, and widely starred, with native plugins for Claude Code, Codex CLI, OpenCode, Hermes Agent, Qoder CLI, and DeepSeek Harness, plus Agent Skills support for many other hosts. It differs from in-context to-do lists by using lifecycle hooks that re-inject the plan each turn and an optional completion gate that blocks stopping until the plan reports complete. Benchmark and A/B results cited in the README are the project's own measurements, and some hosts require Bash and Python 3.10+.

Similar skills

• Karpathy-Inspired Claude Code Guidelines: A single CLAUDE.md with four principles to curb overengineering, silent assumptions, and unrelated edits in Claude Code.
• Scientific Agent Skills: Library of 177 Agent Skills for scientific work in biology, chemistry, medicine, and more, for Claude Code, Cursor, Codex and others.
• reverse-skill: Skill router pack for reverse engineering, pentesting, and security research that routes AI coding agents to the right methodology and toolchain.
• book-to-skill: Converts technical books and document folders (PDF, EPUB, DOCX, MD, HTML and more) into on-demand agent skills for Claude Code and others.
• Hallmark: Design skill for Claude Code, Cursor, and Codex that builds, audits, and redesigns UI while avoiding generic AI-generated looks.
• Claude Skills: Large MIT-licensed library of skills, agents, and slash commands for Claude Code, Codex, Gemini CLI, Cursor, and other coding agents.