Updated 1d ago
by OthmanAdi
planning-with-files
Persistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60+ agents.
27.5k GitHub stars (27,467)
+329 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | +3 |
| Sep 28 | +12 |
| Sep 29 | +24 |
| Sep 30 | +22 |
| Oct 1 | +9 |
| Oct 2 | +44 |
| Oct 3 | +11 |
| Oct 4 | +7 |
| Oct 5 | +11 |
| Oct 6 | +19 |
| Oct 7 | +10 |
| Oct 8 | +14 |
| Oct 9 | +20 |
| Oct 10 | +18 |
| Oct 11 | +17 |
| Oct 12 | +18 |
| Oct 13 | +17 |
| Oct 14 | +18 |
| Oct 15 | +25 |
| Oct 16 | +10 |
- 6 skills (6 skills found in its SKILL.md files)
- 2.3k forks (2,276 forks)
- 1d ago last update (Last updated 1d ago)
Install
Skills CLI
npx skills add OthmanAdi/planning-with-files
Asks which skills and agents to install. Just one: npx skills add OthmanAdi/planning-with-files --skill planning-with-files — add -g for every project.
Claude Code
git clone https://github.com/OthmanAdi/planning-with-filescp -r "planning-with-files/skills/planning-with-files" ~/.claude/skills/
Copies the planning-with-files skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add OthmanAdi/planning-with-files
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
planning-with-files
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.…
skills/planning-with-files/SKILL.md on GitHub (opens in a new tab) -
planning-with-files-ar
تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة…
skills/i18n/planning-with-files-ar/SKILL.md on GitHub (opens in a new tab) -
planning-with-files-de
Persistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten. Hält task_plan.md, findings.md und progress.md auf dem Datenträger; Lebenszyklus-Hooks speisen ausgewählten Planungskontext des Projekts ein. Die automatische Wiederherstellung liest nur die Planungsdateien des Projekts. Nur ein ausdrücklicher Aufruf von session-catchup.py --metadata darf lokale Sitzungsmetadaten desselben P…
skills/i18n/planning-with-files-de/SKILL.md on GitHub (opens in a new tab) -
planning-with-files-es
Planificación persistente basada en archivos para tareas multipaso de agentes de IA. Mantiene task_plan.md, findings.md y progress.md en disco; los hooks del ciclo de vida inyectan contexto seleccionado de planificación del proyecto. La recuperación automática solo lee los archivos de planificación del proyecto. session-catchup.py --metadata, solicitado de forma explícita, puede inspeccionar meta…
skills/i18n/planning-with-files-es/SKILL.md on GitHub (opens in a new tab) -
planning-with-files-zh
用于多步骤 AI 代理工作的持久化文件规划系统。将 task_plan.md、findings.md 和 progress.md 保存在磁盘上,生命周期钩子会注入选定的项目规划上下文。自动恢复只读取项目规划文件。只有显式运行 session-catchup.py --metadata 才会检查本机同项目的会话元数据;--replay 可输出有长度限制且由 nonce 框定的同项目摘录。可选门禁仅在宿主支持时请求继续,绝不执行 Markdown 中声明的命令。本技能没有网络上传路径。适用于研究或需要 5 次以上工具调用的工作。触发词:任务规划、项目计划、制定计划、分解任务、多步骤规划、进度跟踪、文件规划、帮我规划、拆解项目
skills/i18n/planning-with-files-zh/SKILL.md on GitHub (opens in a new tab) -
planning-with-files-zht
用於多步驟 AI 代理工作的持久化檔案規劃。將 task_plan.md、findings.md 與 progress.md 保存在磁碟上,生命週期鉤子會注入選定的專案規劃內容。自動恢復只讀取專案規劃檔案;只有明確執行 session-catchup.py --metadata 才會檢查本機同一專案的代理工作階段中繼資料,--replay 則會輸出有界且以 nonce 框定的摘錄。選用的閘門模式只會在主機支援時要求繼續,而且絕不執行 Markdown 中宣告的命令。此技能沒有網路上傳路徑。適用於研究或需要超過 5 次工具呼叫的工作。觸發詞:任務規劃、專案計畫、制定計畫、分解任務、多步驟規劃、進度追蹤、檔案規劃、幫我規劃、拆解專案
skills/i18n/planning-with-files-zht/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.