How do I install the Plane skill?

Run npx skillmds@latest add dvcrn/plane in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Plane safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Plane?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Plane free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Plane by dvcrn — Agent Skill

Name: Plane
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

Plane Skill

Interact with Plane.so project management via the plane CLI.

Installation

Download the CLI script and make it executable:

curl -o ~/.local/bin/plane https://raw.githubusercontent.com/JinkoLLC/plane-skill/main/scripts/plane
chmod +x ~/.local/bin/plane

Make sure ~/.local/bin is in your PATH.

Setup

export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE="your-workspace-slug"

Get your API key from: Plane → Profile Settings → Personal Access Tokens

The workspace slug is the URL path segment (e.g., for https://app.plane.so/my-team/ the slug is my-team).

Commands

Current User

plane me                      # Show authenticated user info

Workspace Members

plane members                 # List all workspace members (name, email, role, ID)

Projects

plane projects list                                      # List all projects
plane projects get PROJECT_ID                            # Get project details
plane projects create --name "My Project" --identifier "PROJ"  # Create project

Work Items (Issues)

# List work items
plane issues list -p PROJECT_ID
plane issues list -p PROJECT_ID --priority high --assignee USER_ID

# Get details
plane issues get -p PROJECT_ID ISSUE_ID

# Create
plane issues create -p PROJECT_ID --name "Fix login bug" --priority high
plane issues create -p PROJECT_ID --name "Feature" --assignee USER_ID --label LABEL_ID

# Update
plane issues update -p PROJECT_ID ISSUE_ID --state STATE_ID --priority medium

# Assign to members
plane issues assign -p PROJECT_ID ISSUE_ID USER_ID_1 USER_ID_2

# Delete
plane issues delete -p PROJECT_ID ISSUE_ID

# Search across workspace
plane issues search "login bug"

Comments

plane comments list -p PROJECT_ID -i ISSUE_ID            # List comments on a work item
plane comments list -p PROJECT_ID -i ISSUE_ID --all      # Show all activity (not just comments)
plane comments add -p PROJECT_ID -i ISSUE_ID "Looks good, merging now"  # Add a comment

Cycles (Sprints)

plane cycles list -p PROJECT_ID
plane cycles get -p PROJECT_ID CYCLE_ID
plane cycles create -p PROJECT_ID --name "Sprint 1" --start 2026-01-27 --end 2026-02-10

Modules

plane modules list -p PROJECT_ID
plane modules get -p PROJECT_ID MODULE_ID
plane modules create -p PROJECT_ID --name "Auth Module" --description "Authentication features"

States & Labels

plane states -p PROJECT_ID    # List workflow states (useful for getting state IDs)
plane labels -p PROJECT_ID    # List labels (useful for getting label IDs)

Output Formats

Default output is a formatted table. Add -f json for raw JSON:

plane projects list -f json
plane issues list -p PROJECT_ID -f json

Typical Workflow

plane projects list — find your project ID
plane states -p PROJECT_ID — see available states
plane members — find member IDs for assignment
plane issues create -p PROJECT_ID --name "Task" --priority high --assignee USER_ID
plane comments add -p PROJECT_ID -i ISSUE_ID "Started working on this"

---name: planedescription: Manage Plane.so projects and work items using the `plane` CLI. List projects, create/update/search issues, manage cycles and modules, add comments, and assign members.---# Plane SkillInteract with [Plane.so](https://plane.so) project management via the `plane` CLI.## InstallationDownload the CLI script and make it executable:```bashcurl -o ~/.local/bin/plane https://raw.githubusercontent.com/JinkoLLC/plane-skill/main/scripts/planechmod +x ~/.local/bin/plane```Make sure `~/.local/bin` is in your PATH.## Setup```bashexport PLANE_API_KEY="your-api-key"export PLANE_WORKSPACE="your-workspace-slug"```Get your API key from: **Plane → Profile Settings → Personal Access Tokens**The workspace slug is the URL path segment (e.g., for `https://app.plane.so/my-team/` the slug is `my-team`).## Commands### Current User```bashplane me # Show authenticated user info```### Workspace Members```bashplane members # List all workspace members (name, email, role, ID)```### Projects```bashplane projects list # List all projectsplane projects get PROJECT_ID # Get project detailsplane projects create --name "My Project" --identifier "PROJ" # Create project```### Work Items (Issues)```bash# List work itemsplane issues list -p PROJECT_IDplane issues list -p PROJECT_ID --priority high --assignee USER_ID# Get detailsplane issues get -p PROJECT_ID ISSUE_ID# Createplane issues create -p PROJECT_ID --name "Fix login bug" --priority highplane issues create -p PROJECT_ID --name "Feature" --assignee USER_ID --label LABEL_ID# Updateplane issues update -p PROJECT_ID ISSUE_ID --state STATE_ID --priority medium# Assign to membersplane issues assign -p PROJECT_ID ISSUE_ID USER_ID_1 USER_ID_2# Deleteplane issues delete -p PROJECT_ID ISSUE_ID# Search across workspaceplane issues search "login bug"```### Comments```bashplane comments list -p PROJECT_ID -i ISSUE_ID # List comments on a work itemplane comments list -p PROJECT_ID -i ISSUE_ID --all # Show all activity (not just comments)plane comments add -p PROJECT_ID -i ISSUE_ID "Looks good, merging now" # Add a comment```### Cycles (Sprints)```bashplane cycles list -p PROJECT_IDplane cycles get -p PROJECT_ID CYCLE_IDplane cycles create -p PROJECT_ID --name "Sprint 1" --start 2026-01-27 --end 2026-02-10```### Modules```bashplane modules list -p PROJECT_IDplane modules get -p PROJECT_ID MODULE_IDplane modules create -p PROJECT_ID --name "Auth Module" --description "Authentication features"```### States & Labels```bashplane states -p PROJECT_ID # List workflow states (useful for getting state IDs)plane labels -p PROJECT_ID # List labels (useful for getting label IDs)```## Output FormatsDefault output is a formatted table. Add `-f json` for raw JSON:```bashplane projects list -f jsonplane issues list -p PROJECT_ID -f json```## Typical Workflow1. `plane projects list` — find your project ID2. `plane states -p PROJECT_ID` — see available states3. `plane members` — find member IDs for assignment4. `plane issues create -p PROJECT_ID --name "Task" --priority high --assignee USER_ID`5. `plane comments add -p PROJECT_ID -i ISSUE_ID "Started working on this"`

Frequently asked questions

Plane