← Back to Skills Marketplace
76
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install plane-flow
Description
Operate a local/self-hosted Plane workspace for product and project flow management. Use when the user wants to read or update Plane projects, issues, states...
Usage Guidance
This package appears to do what it says: connect to a self-hosted Plane instance and manage projects/issues. Before installing or enabling it for non-technical users, have an administrator: 1) provision a least-privileged PLANE_API_TOKEN and confirm the token scope, 2) set PLANE_BASE_URL to your internal Plane endpoint (network-restrict this endpoint if possible), 3) validate connectivity with python3 scripts/test_connection.py, and 4) only run scripts/init_config.py as an admin who understands it will write ~/.plane_config.yaml. Be cautious when uploading attachments (the skill reads files you explicitly provide). If you need stronger assurance, review the token scope and run the scripts in a controlled environment first.
Capability Analysis
Type: OpenClaw Skill
Name: plane-flow
Version: 0.1.3
The skill bundle provides integration with the Plane project management system and includes functionality to upload local files as attachments. A potential vulnerability exists in `scripts/service.py`, where a custom markdown directive `[image: path]` triggers a file read and upload via `scripts/client.py` without path validation, which could be exploited to exfiltrate sensitive local files if the agent processes untrusted input. Additionally, the bundle includes `scripts/run_with_env.py`, which uses `runpy.run_path` to execute arbitrary Python scripts, representing a high-risk capability intended for administrative setup.
Capability Tags
Capability Assessment
Purpose & Capability
Name and description match the implemented behavior: bundled Python scripts talk to a Plane instance and perform read/write operations. Required binaries (python3) and env vars (PLANE_BASE_URL, PLANE_API_TOKEN, PLANE_WORKSPACE_ID) are appropriate for this purpose.
Instruction Scope
SKILL.md and the CLI scripts constrain runtime behavior to contacting the configured Plane instance and optionally reading files explicitly provided for attachment uploads. The instructions do not direct the agent to read unrelated system files or exfiltrate data to unexpected endpoints.
Install Mechanism
This is an instruction-only skill with bundled Python scripts; there is no high-risk download/install step. It relies on common Python packages (requests, optional PyYAML/markdown) which is proportionate to the task.
Credentials
The skill requires only the expected Plane-related env vars (base URL, API token, workspace ID). No other unrelated secrets or credentials are requested. An optional PLANE_CONFIG_FILE is clearly documented for local aliasing/mappings.
Persistence & Privilege
The skill does not request always:true and does not modify other skills' configurations. The only write behavior is an admin-only init helper that writes ~/.plane_config.yaml when intentionally run.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install plane-flow - After installation, invoke the skill by name or use
/plane-flow - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Use Plane's native image-component nodes for correct left/center/right alignment. Add --image-align flag to issues create, issues update-desc, and comments create. Add [image: path, align] directive for per-image control in descriptions. Alignment options: left, center (default), right. Note: true text wrapping is not supported by Plane's editor.
v0.1.1
Clarify runtime requirements, required Plane environment variables, credential expectations, and admin-only local helper behavior for safer review and installation.
v0.1.0
Initial public release: self-hosted Plane workflow skill with admin-first setup, conversational business-user workflow support, bundled issue/project helpers, interactive init helper, and publish-ready cleanup.
Metadata
Frequently Asked Questions
What is Plane Flow?
Operate a local/self-hosted Plane workspace for product and project flow management. Use when the user wants to read or update Plane projects, issues, states... It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.
How do I install Plane Flow?
Run "/install plane-flow" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Plane Flow free?
Yes, Plane Flow is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Plane Flow support?
Plane Flow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Plane Flow?
It is built and maintained by uncooldog (@uncooldog); the current version is v0.1.3.
More Skills