Discover the toolingbehind modern intelligence
The operating system for AI infrastructure discovery. Search a live map of MCP servers, AI agents, LLM tools, automation systems, and developer infrastructure.
planning-with-files
Persistent file-based planning for long-running agentic tasks. Crash-proof markdown plans, deterministic completion gate, multi-agent shared state on disk. Works with Claude Code, Codex CLI, Cursor, Hermes agent, Pi, Kiro, OpenCode and 60+ agents via the SKILL.md standard.
23.1kstars
2kforks
Python
agent-skillsagentic-workflowsai-agentsautonomous-agentsclaudeclaude-codeclaude-skillscodexcopilotcopilot-skillscursorhermes
Quality signals
ActiveNo testsNo CIThin docsNo licensePopular
AI summary
Auto-generated overview of what this skill does and when to reach for it.
Persistent markdown planning workflow inspired by Manus, the $2B acquisition, for structuring and tracking complex development tasks in files.
Use this when
- You're juggling multiple interconnected tasks and need a clear overview
- You want to maintain a persistent plan across coding sessions
- You need to break down large projects into manageable markdown files
- You're collaborating and want shared progress visibility
- You prefer file-based planning over chat-based workflows
Don't use when
- For simple, linear tasks that don't need persistent tracking
- If you prefer real-time chat over file-based planning
- When you need a GUI-based project management tool
Capabilities
- Creates and maintains markdown-based task plans in .plans/ directory
- Supports parallel task execution with progress tracking
- Provides session recovery and plan attestation
- Includes IDE-specific variants (.continue, .gemini, .kiro)
- Offers POSIX-compliant shell scripts for plan management
- Supports topic handoff for long-running operational workflows
InstallSKILLInstall as a Claude Code skill
Universal installANY TOOL
$ npx skillcity@latest OthmanAdi/planning-with-filesAuto-detects the skill or MCP server in this repo and installs it for Claude Code, Codex, Cursor, Cline, OpenCode, Gemini CLI, Anti-Gravity, OpenClaw and Hermes.
Requires Node.js 18+ (ships with npx).
Or install manually
# Install into ~/.claude/skills/ mkdir -p ~/.claude/skills/planning-with-files curl -fsSL https://raw.githubusercontent.com/OthmanAdi/planning-with-files/main/SKILL.md -o ~/.claude/skills/planning-with-files/SKILL.md
Loading README…
Ask a simulated agent to run this skill. It loads the real SKILL.md and reasons over your task with NVIDIA.
planning-with-files — sandboxAI sandbox
Pick a quick prompt below or type your own — watch the agent execute this skill step by step.
guest@skillcity:~$Try a prompt