OthmanAdi/planning-with-files
This skill enables AI agents to maintain continuity across long-running tasks by storing task plans, findings, and progress directly on disk. By utilizing dedicated files for state tracking and lifecycle hooks for context injection, it prevents context rot in complex sequences.
It is designed for research or automation work requiring extensive tool calls, providing a mechanism for automatic recovery and session catch-up without relying on network uploads.
Claude
Codex
Cursor
Gemini CLI
OpenClaw
Copilot
Amp
OpenCode
Kiro
Hermes
Pi
Antigravity
Devin
Kilo Code
DeepSeek
Factory DroidUse this skill collection
Follow the documented setup, then try a first task.
Claude Code plugin
Installs: Full planning-with-files plugin: skill, slash commands, and lifecycle hooks. · Claude Code
- Current stable Claude Code release
Enter this command in a Claude Code session to add the author's plugin marketplace.
/plugin marketplace add OthmanAdi/planning-with-files
Then enter this command in the Claude Code session to install the plugin.
/plugin install planning-with-files@planning-with-files
Claude Code local plugin checkout
Installs: Session-only full plugin loaded from a local repository checkout. · Claude Code
- Git
- Current stable Claude Code release
In a terminal, clone the repository into the current directory.
git clone https://github.com/OthmanAdi/planning-with-files.git
From the same terminal directory, start Claude Code with the newly created checkout as a session-only plugin.
claude --plugin-dir ./planning-with-files
Claude Code standalone skill
Installs: English planning-with-files skill only, without the full plugin structure; standalone hooks activate after the skill is invoked. · Claude Code
- Git
- A POSIX-like shell with mkdir and cp
Platform: POSIX-like environments
In a terminal, clone the repository into the current directory.
git clone https://github.com/OthmanAdi/planning-with-files.git
Create the Claude Code user skills directory.
mkdir -p ~/.claude/skills
Copy the repository's English planning-with-files skill folder into the Claude Code user skills directory.
cp -r planning-with-files/skills/planning-with-files ~/.claude/skills/
Claude Code extracted skill
Installs: English planning-with-files skill folder extracted from the repository archive, without the full plugin structure. · Claude Code
- A POSIX-like shell with curl and tar
Platform: POSIX-like environments
In a terminal, extract the English skill into the current directory.
curl -L https://github.com/OthmanAdi/planning-with-files/archive/master.tar.gz | tar -xzv --strip-components=2 "planning-with-files-master/skills/planning-with-files"
Manually move the extracted planning-with-files/ directory to ~/.claude/skills/.
Global Agent Skills install
Installs: Global English planning-with-files skill, scripts, and templates; no slash commands and no SessionStart hook. · Agent Skills-compatible agents
- npx
Run this command in a terminal to install the English planning-with-files skill globally.
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g
Global German skill
Installs: German planning-with-files language variant only; it does not install the English skill or other translations. · Agent Skills-compatible agents
- npx
Run this command in a terminal to install the German language variant globally.
npx skills add OthmanAdi/planning-with-files --skill planning-with-files-de -g
npm project dependency
Installs: Version-pinnable project dependency containing SKILL.md, scripts, and templates; it does not register hooks by itself. · Agents integrated by the project
- npm
Run from: The target project directory
Run this command in a terminal from the project where the package should be recorded as a dependency.
npm install planning-with-files
Hermes Agent native bundle
Installs: Hermes-specific planning-with-files skill bundle plus native plugin and Hermes commands. · Hermes Agent CLI, Hermes Agent Desktop
- Hermes Agent with the hermes CLI
In a terminal, install the Hermes-specific skill bundle. The canonical skill path is not used because the documentation says Hermes' skills-guard scanner refuses it.
hermes skills install OthmanAdi/planning-with-files/.hermes/skills/planning-with-files --yes
In a terminal, install the native Hermes plugin.
hermes plugins install OthmanAdi/planning-with-files/.hermes/plugins/planning-with-files
In a terminal, enable the installed plugin.
hermes plugins enable planning-with-files