← Back to Skills Marketplace
621
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install planning-with-files-from-github
Description
This skill should be used when the user asks to start a complex task, research project, multi-step implementation, or any task expected to require more than...
Usage Guidance
This skill appears to be what it says: a filesystem-based planning helper that creates and updates three markdown files and runs two small shell scripts. Before installing or enabling it, review and confirm these points:
- Permission scope: the skill requires the agent to be allowed to run 'exec' and write files (group:runtime, group:fs). Only grant those if you trust the agent and workspace.
- Persistence/privacy: the workflow intentionally writes fetched/search results and notes to disk (findings.md). Do not use this skill in directories that may contain sensitive files or credentials. Consider using a dedicated project workspace or setting OPENCLAW_WORKDIR to a safe path.
- Implicit env var: the scripts honor OPENCLAW_WORKDIR (defaulting to pwd) though it isn't declared in SKILL.md — be aware where files will be created.
- Inspect scripts/templates: the bundled scripts are short and local; if you have concerns, review them before use and restrict the skill to workspace-level installation (README shows how).
- Autonomy: the agent may invoke the skill for eligible complex tasks; if you prefer manual control, adjust skill availability or agent permissions.
If you want a higher level of assurance, run the scripts in a disposable workspace to observe behavior, or ask the author for clarification on OPENCLAW_WORKDIR and any intended defaults.
Capability Analysis
Type: OpenClaw Skill
Name: planning-with-files-from-github
Version: 1.0.0
The skill bundle implements a persistent planning workflow by managing markdown files (task_plan.md, findings.md, progress.md) via local bash scripts. The logic in SKILL.md and the scripts (init-session.sh, check-complete.sh) is transparent, focused on task state management, and lacks any indicators of data exfiltration, unauthorized network access, or malicious prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: the skill implements a filesystem-backed planning workflow, provides templates, and includes simple init/check scripts. Requiring filesystem access and the ability to exec local scripts is appropriate for this purpose.
Instruction Scope
SKILL.md is prescriptive: it requires running scripts (init-session.sh, check-complete.sh), creating/updating task_plan.md, findings.md, and progress.md, and following the '2-Action Rule' to persist fetched information. This stays within the planning scope, but it does mandate persisting fetched/viewed data to disk (which may include sensitive content) and implicitly relies on an OPENCLAW_WORKDIR environment variable inside the scripts (the SKILL.md does not mention this env var).
Install Mechanism
No install spec or remote downloads. The skill is instruction-first and ships small local shell scripts and templates — low-risk from an install perspective. Scripts are simple, readable, and create files from local templates; nothing is fetched from external URLs.
Credentials
The skill declares no required env vars or credentials, which is consistent with its purpose. However, the scripts optionally read OPENCLAW_WORKDIR (falling back to pwd) but that variable is not declared in SKILL.md. The skill requires permission to run the exec tool and write to the filesystem — reasonable but should be consciously granted.
Persistence & Privilege
always:false (no forced global presence). The skill writes files in the working directory and will stop the agent from finishing until check-complete.sh returns success, which is expected behaviour for a planning workflow. It does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install planning-with-files-from-github - After installation, invoke the skill by name or use
/planning-with-files-from-github - 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.
- Supports structured planning for complex, multi-phase or research-heavy tasks.
- Introduces persistent markdown-based planning files: task_plan.md (goal tracker), findings.md (knowledge store), and progress.md (session log).
- Specifies detailed protocols for session start, error recovery, file updating, and completion verification.
- Designed to minimize goal drift and support seamless session recovery for long, multi-step projects.
Metadata
Frequently Asked Questions
What is planning-with-files?
This skill should be used when the user asks to start a complex task, research project, multi-step implementation, or any task expected to require more than... It is an AI Agent Skill for Claude Code / OpenClaw, with 621 downloads so far.
How do I install planning-with-files?
Run "/install planning-with-files-from-github" 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 yingcd (@yingcd); the current version is v1.0.0.
More Skills