← Back to Skills Marketplace
wpank

Planning With Files

by wpank · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
1530
Downloads
6
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install planning-files
Description
File-based planning for complex tasks. Use persistent markdown files as working memory to survive context resets. Creates task_plan.md, findings.md, and progress.md. Use for any task requiring >5 tool calls, research projects, or multi-step implementations.
Usage Guidance
This skill is internally coherent and appears to do what it says — create and maintain three markdown files as persistent planning memory. Before installing or running it, consider: 1) The planning files (task_plan.md, findings.md, progress.md) will be created in your project root and persist on disk (and in your git history if committed). Do not log secrets or sensitive data there. 2) Review the included scripts (init-session.sh, check-complete.sh) — they are simple shell scripts that create/check files, but you should inspect them and run in a safe folder first. 3) If you use version control, consider adding these files to .gitignore or keeping them in a sandbox workspace to avoid accidental leakage. 4) The package source/homepage is unknown; although there are no network endpoints or remote installs in the package itself, prefer installing from a trusted source or inspecting the files locally before adding to long-running agents. 5) The agent can invoke skills autonomously by default; if you plan to run this skill in an autonomous agent, be mindful that it will create/modify files without prompting. If you want further checks (e.g., to ensure it never writes outside a specific directory), provide that constraint and I can point out the exact lines to change.
Capability Analysis
Type: OpenClaw Skill Name: planning-files Version: 1.0.0 The OpenClaw AgentSkills bundle 'planning-files' is designed to enhance an AI agent's planning and memory by utilizing local markdown files as persistent storage. All scripts (`scripts/check-complete.sh`, `scripts/init-session.sh`) perform benign local file operations (creating, reading, and parsing markdown files) strictly within the stated purpose. The `SKILL.md` and `references/manus-principles.md` contain instructions and guidelines for the AI agent that promote disciplined workflow, error handling, and context management, without any evidence of prompt injection designed for malicious activities like data exfiltration, unauthorized execution, or ignoring user instructions. The `README.md` includes installation instructions, one of which (`npx add https://github.com/wpank/ai/tree/main/skills/meta/planning-with-files`) is non-standard but does not indicate malicious intent within the skill's operational logic. Overall, the skill aligns with its stated purpose and lacks any high-risk behaviors or malicious indicators.
Capability Assessment
Purpose & Capability
Name/description match the behavior: the skill creates and manages three markdown files and provides helper scripts and templates to treat the filesystem as persistent memory. There are no unrelated environment variables, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs the agent to create/read/write task_plan.md, findings.md, and progress.md, and to run simple local commands (ls, cat, git diff --stat). This is coherent with the planning purpose. Note: the skill intentionally instructs persistent file creation in the project root and to log errors and discoveries; users should be aware that anything written to these files will persist on disk (and in git history if committed).
Install Mechanism
Instruction-only skill with no install spec that downloads/executes remote archives. Helper scripts are included in the package; there is no installer that fetches arbitrary code from untrusted URLs.
Credentials
Skill requires no environment variables, credentials, or config paths. The files and scripts operate on local files only, which is proportionate to the stated functionality.
Persistence & Privilege
always:false and no elevated privileges requested. The skill writes files in the project directory and includes small helper scripts; this is consistent with its purpose and does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install planning-files
  3. After installation, invoke the skill by name or use /planning-files
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of planning-with-files skill. - Enables robust file-based planning for complex, multi-step tasks. - Introduces use of three persistent markdown files—task_plan.md, findings.md, progress.md—as working memory to overcome context resets. - Provides clear usage guidelines, workflow, error-handling protocol, and anti-patterns. - Includes templates and helper scripts for easy setup and best practices.
Metadata
Slug planning-files
Version 1.0.0
License
All-time Installs 7
Active Installs 6
Total Versions 1
Frequently Asked Questions

What is Planning With Files?

File-based planning for complex tasks. Use persistent markdown files as working memory to survive context resets. Creates task_plan.md, findings.md, and progress.md. Use for any task requiring >5 tool calls, research projects, or multi-step implementations. It is an AI Agent Skill for Claude Code / OpenClaw, with 1530 downloads so far.

How do I install Planning With Files?

Run "/install planning-files" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Planning With Files free?

Yes, Planning With Files is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Planning With Files support?

Planning With Files is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Planning With Files?

It is built and maintained by wpank (@wpank); the current version is v1.0.0.

💬 Comments