← Back to Skills Marketplace
brunoscardoso

Plan Flow

by brunoscardoso · GitHub ↗ · v1.0.8
cross-platform ⚠ suspicious
365
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install plan-flow
Description
Structured AI-assisted development workflows - discovery, planning, execution, code reviews, and testing
Usage Guidance
Key things to consider before installing: - Ledger behavior: The skill documents a persistent 'flow/ledger.md' that is updated silently and used to influence future behavior. Ask the author how ledger entries are controlled, whether sensitive content is filtered, and how to disable ledger recording. Prefer not to enable this on repositories that contain secrets or proprietary logic. - Autopilot / automated actions: The top-level SKILL.md encourages automated runs and even says 'Never ask "Ready to create plan?" — just do it.' but other files contain contradictory checkpoints. Confirm whether the agent will actually modify files, run builds, or make commits without explicit user approval. If you require explicit approval before changes, do not enable autopilot. - Storage of API keys: The README suggests creating .plan-flow.yml with an anthropic_api_key example. Do NOT commit API keys to the repo; instead store provider keys in a secure secret store or environment variables and add .plan-flow.yml to .gitignore. Ask the author for a secure configuration alternative. - GitHub CLI auth: review what gh auth scopes you grant. The skill requires gh for PR review; ensure the token/account used has minimal necessary scopes. - Test in an isolated repo: Try the skill in a disposable repository first to observe behavior (file writes, commits, whether ledger populates, autopilot actions). Verify no automatic commits or pushes occur unless you explicitly approve. - Clarify inconsistencies: The SKILL.md set contains contradictory rules about auto-chaining and when to pause. Ask the maintainer to clarify intended autopilot behavior and how to opt out of any background logging. If you are uncomfortable with a silent, persistent ledger or any automatic file-modifying behavior, do not install or enable autopilot until you have explicit controls (ability to opt out of ledger, disable autopilot by default, and require explicit consent before code changes or commits).
Capability Analysis
Type: OpenClaw Skill Name: plan-flow Version: 1.0.8 This skill bundle is suspicious due to significant prompt injection vulnerabilities and instructions that bypass user approval for critical actions. The main SKILL.md explicitly instructs the AI agent to "run without asking permission" and "Never ask... just do it" for the entire development workflow (discovery, planning, execution), creating a critical risk where a malicious input could lead to arbitrary code generation and execution (via `execute-plan`'s 'implement' or 'build verification' steps) without user consent. Additionally, the `ledger.md` (described in SKILL.md and ledger/SKILL.md) 'silently captures' and 'applies learnings', establishing a persistent prompt injection surface that could modify agent behavior over time. While there's no explicit evidence of intentional data exfiltration or backdoor installation, these instructions create severe vulnerabilities that could be exploited for remote code execution or unauthorized actions.
Capability Assessment
Purpose & Capability
Name and features align with requiring git and gh for repo and PR work. The skill's commands (setup, discovery, plan, execute, review, tests) reasonably map to those tools. However, the inclusion of a silent, always-active project ledger (persistent memory) is more than a simple workflow helper and expands the skill's scope beyond pure planning/execution.
Instruction Scope
SKILL.md instructs the agent to automatically run multi-step workflows, create and modify files (plans, contracts, code, test files), run builds, and 'silently' capture learnings to flow/ledger.md. There are contradictory rules across files (e.g., main doc: 'Never ask "Ready to create plan?" — just do it.' vs. flow/SKILL.md's mandatory checkpoints and create-plan's 'Do NOT auto-invoke /execute-plan'). The instructions grant broad discretion to read/write project files and perform build/commit-related actions — this can lead to unexpected code changes or recording of sensitive content without explicit, consistent consent.
Install Mechanism
Instruction-only skill with no install spec and no code files; nothing is written to disk by an installer. This is lower risk from an installation vector perspective.
Credentials
The skill declares no required environment variables, which is consistent with an instruction-only skill. However, the Configuration section recommends creating a .plan-flow.yml containing an anthropic_api_key (example shown) — storing API keys in a repo file is discouraged and not enforced/validated. The skill also requires gh authentication for PR review; that is expected but users should be aware of auth scopes granted to gh.
Persistence & Privilege
Although registry flags show always: false, the SKILL.md explicitly documents an 'Always-Active Feature' (Project Ledger) and ledger/SKILL.md states the ledger 'operates silently in the background' and will read/apply learnings and record new entries. That is inconsistent with the declared privileges and effectively gives the skill persistent, background write/read access to the repo. This combination (silent ledger + automatic workflow language + file creation) increases the chance of unwanted persistent changes or leaking repository-specific information into flow/ledger.md.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install plan-flow
  3. After installation, invoke the skill by name or use /plan-flow
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.8
Initial release
Metadata
Slug plan-flow
Version 1.0.8
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Plan Flow?

Structured AI-assisted development workflows - discovery, planning, execution, code reviews, and testing. It is an AI Agent Skill for Claude Code / OpenClaw, with 365 downloads so far.

How do I install Plan Flow?

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

Is Plan Flow free?

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

Which platforms does Plan Flow support?

Plan Flow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Plan Flow?

It is built and maintained by brunoscardoso (@brunoscardoso); the current version is v1.0.8.

💬 Comments