Agent skill

Cycle Plan

Plan Linear cycles using velocity analytics. An agent skill from joa23/linear-cli.

MITAuto-check passedProduct & Project Management

Install Cycle Plan

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/cycle-plan .claude/skills/cycle-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .claude/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/cycle-plan .agents/skills/cycle-plan && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .agents/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/cycle-plan .cursor/skills/cycle-plan && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .cursor/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/joa23/linear-cli.git --path .claude/skills/cycle-plan

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/cycle-plan .gemini/skills/cycle-plan && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .gemini/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/cycle-plan .github/skills/cycle-plan && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .github/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add joa23/linear-cli --skill cycle-plan -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install joa23/linear-cli cycle-plan --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/joa23/linear-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/cycle-plan .opencode/skills/cycle-plan && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "cycle-plan" agent skill from https://github.com/joa23/linear-cli/tree/main/.claude/skills/cycle-plan into .opencode/skills/cycle-plan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cycle-plan", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: cycle-plan
GitHub stars: 144
Token cost: ~1.2k tokens
SKILL.md length: 228 words
Files: 1
Skills in repo: 8
Repo updated: Sep 13, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Plan Linear cycles using velocity analytics. An agent skill from joa23/linear-cli.

Works in 5 steps: Analyze Historical Velocity → Review Available Capacity → Get Issues for Planning → …
Product & Project Management work in your project
SKILL.md covers When to Use, Process, Velocity Analysis and Planning Output, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Cycle Plan is an agent skill from joa23/linear-cli. Plan Linear cycles using velocity analytics. Suggests scope based on historical capacity, identifies dependency risks, balances workload.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management. The repository describes itself as: A token-efficient CLI for Linear. The licence is MIT.

When your agent uses it

Product & Project Management work in your project

Example prompts

“/cycle-plan”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Analyze Historical Velocity
Review Available Capacity
Get Issues for Planning
Select Issues for Cycle
Validate Plan

What it can do on your machine

Read from SKILL.md and the folder at commit 575c6f0. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cycle Plan loads about 1.2k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 228 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~37
When it runs · the whole SKILL.md, loaded when a task matches: ~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from joa23/linear-cli at commit 575c6f0, republished under its MIT licence (© joa23). 228 words, ~1,164 tokens.

Download SKILL.mdSave it as .claude/skills/cycle-plan/SKILL.md (or your agent's skills folder).

name: cycle-plan
description: Plan Linear cycles using velocity analytics. Suggests scope based on historical capacity, identifies dependency risks, balances workload.

Cycle Plan Skill - Sprint Planning

You are an expert at planning software development cycles based on team velocity.

When to Use

Use this skill when:

Planning the next sprint/cycle
Deciding what to include in a cycle
Balancing workload across team members

Process

CRITICAL: Setup First

ALWAYS check if .linear.yaml exists. If not, run:

bash

linear init  # Select default team - REQUIRED for cycle operations

Analyze Historical Velocity
bash
```
linear cycles analyze --team ENG --count 10 --format full
```
Parse the JSON to extract velocity metrics, completion rates, and recommendations.
Review Available Capacity
- Check team size
- Account for PTO/holidays
- Consider focus time needs
- Use P20/P50/P80 recommendations from analyze command

Get Issues for Planning

bash

# Get backlog issues (returns ALL issues, not just assigned)
linear issues list --state Backlog --format full --limit 100

# Get current cycle issues
linear issues list --cycle current --format full

# Get next cycle issues (if already planned)
linear issues list --cycle next --format full

Select Issues for Cycle
- Start with P1/P2 issues (--priority 1 or --priority 2)
- Respect dependencies (use linear deps --team ENG)
- Balance across team members
- Stay within recommended capacity
Validate Plan
- Total estimates <= capacity
- No cross-cycle blockers
- Even distribution

Velocity Analysis

The linear cycles analyze command provides:

VELOCITY ANALYSIS: Team ENG (5 cycles)
════════════════════════════════════════
Average Velocity: 34 points/cycle
Completion Rate: 85%
Scope Creep: 12%

CYCLE HISTORY
────────────────────────────────────────
Cycle 23: 38 pts (92% complete)
Cycle 22: 32 pts (88% complete)
Cycle 21: 35 pts (82% complete)
Cycle 20: 28 pts (78% complete)
Cycle 19: 37 pts (90% complete)

RECOMMENDATION
────────────────────────────────────────
Target: 32-36 points for next cycle
Buffer: Reserve 10% for unplanned work

Planning Output

CYCLE PLAN: Sprint 24
════════════════════════════════════════
Capacity: 40 points (4 engineers)
Target: 36 points (90% capacity)
Buffer: 4 points for unplanned work

PLANNED ISSUES
────────────────────────────────────────
ENG-201 [P1] Auth refactor      8pts @alice
ENG-202 [P1] Payment fix        5pts @bob
ENG-203 [P2] Dashboard update   8pts @carol
ENG-204 [P2] API optimization   5pts @dave
ENG-205 [P3] Docs update        3pts @alice
ENG-206 [P3] Test coverage      5pts @bob
────────────────────────────────────────
Total: 34 points

WORKLOAD BALANCE
────────────────────────────────────────
@alice: 11 pts (28%)
@bob:   10 pts (25%)
@carol: 8 pts (20%)
@dave:  5 pts (13%)
Unassigned: 0 pts

DEPENDENCY RISKS
────────────────────────────────────────
ENG-203 blocked by ENG-201 (same cycle - OK)

Commands Used

bash

# FIRST: Ensure team context is set
linear init  # If .linear.yaml doesn't exist

# Analyze velocity (ALWAYS do this first)
linear cycles analyze --team ENG --count 10 --format full

# Get backlog issues for planning (returns ALL issues, not just assigned)
linear issues list --state Backlog --format full --limit 100

# Get high priority issues
linear issues list --priority 1 --format full

# Get issues by cycle
linear issues list --cycle current --format full
linear issues list --cycle next --format full
linear issues list --cycle 65 --format full  # Specific cycle number

# Filter by multiple criteria
linear issues list --state Backlog --priority 1 --labels customer --format full

# Check dependencies
linear deps --team ENG

# Assign to cycle
linear issues update ENG-201 --cycle current
linear issues update ENG-202 --cycle next
linear issues update ENG-203 --cycle 65  # Specific cycle number

Key Learnings

linear issues list returns ALL issues (not just assigned to you)
Use --format full for parsing output in scripts
Cycle numbers require team context from linear init
Always run linear cycles analyze before planning to understand capacity
Use filters to narrow results: --state, --priority, --labels, --cycle, --assignee

Best Practices

Leave buffer - Plan to 80-90% capacity
Front-load blockers - Schedule blocking issues early
Balance workload - Distribute evenly across team
Avoid cross-cycle deps - Don't plan work blocked by next cycle

Files

Just SKILL.md in .claude/skills/cycle-plan of joa23/linear-cli.

Open the folder on GitHubat commit 575c6f0

Compare with similar skills

Cycle Plan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cycle Plan compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Cycle Plan this skilljoa23/linear-cli	144	—	~1.2k	Automated safety check: Pass	MIT	24 days ago
User Story Writerdeanpeters/Product-Manager-Skills	7.2k	2 repos	~2.9k	Automated safety check: Pass	Custom licence	1 mo ago
Game Changing FeaturesopenstatusHQ/data-table-filters	2.3k	3 repos	~2.1k	Automated safety check: Pass	MIT	6 days ago
CCPM Project Managementautomazeio/ccpm	8.4k	—	~1.1k	Automated safety check: Pass	MIT	6 mo ago
Convex Create Componentspokvulcan/poker-planning	114	8 repos	~2.6k	Automated safety check: Pass	MIT	3 days ago
Self Improving Agentfarm-fe/farm	5.6k	2 repos	~3.3k	Automated safety check: Notes	MIT	16 days ago

Similar skills

User Story Writer
deanpeters/Product-Manager-Skills
Writes user stories in Mike Cohn's format with Gherkin acceptance criteria, turning user needs into development-ready work with testable conditions.
7.2k GitHub starsUsed in 2 repos~2.9k tokens
Product & Project ManagementAuto-check passed
Game Changing Features
openstatusHQ/data-table-filters
Find 10x product opportunities and high-leverage improvements.
2.3k GitHub starsUsed in 3 repos~2.1k tokens
Product & Project ManagementAuto-check passed
CCPM Project Management
automazeio/ccpm
Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.
8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
Product & Project ManagementAuto-check passed
Convex Create Component
spokvulcan/poker-planning
Builds reusable Convex components with isolated tables and app-facing APIs.
114 GitHub starsUsed in 8 repos~2.6k tokens
Product & Project ManagementAuto-check passed
Self Improving Agent
farm-fe/farm
A universal self-improving agent that learns from ALL skill experiences.
5.6k GitHub starsUsed in 2 repos~3.3k tokens
Product & Project ManagementAuto-check: notes
Weekly Engineering Retro
garrytan/gstack
Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.
136k GitHub stars~2.4k tokensUpdated today
Product & Project ManagementAuto-check passed

Questions about Cycle Plan

What does Cycle Plan do?

Plan Linear cycles using velocity analytics. An agent skill from joa23/linear-cli. Cycle Plan is an agent skill from joa23/linear-cli. Plan Linear cycles using velocity analytics.

When should I use Cycle Plan?

Cycle Plan fits situations like: product & Project Management work in your project.

How do I install Cycle Plan in Claude Code?

Run `npx skills add joa23/linear-cli --skill cycle-plan -a claude-code`. Or copy the skill folder (.claude/skills/cycle-plan in joa23/linear-cli) into .claude/skills/cycle-plan in your project. Claude Code loads it when a task matches its description.

How do I install Cycle Plan in Codex?

Run `npx skills add joa23/linear-cli --skill cycle-plan -a codex`. Or copy the skill folder (.claude/skills/cycle-plan in joa23/linear-cli) into .agents/skills/cycle-plan in your project. Codex loads it when a task matches its description.

Can I use Cycle Plan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add joa23/linear-cli --skill cycle-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cycle-plan, .gemini/skills/cycle-plan, .github/skills/cycle-plan and .opencode/skills/cycle-plan in your project.

What does Cycle Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: Cycle Plan is instructions for the agent only.

Does Cycle Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cycle Plan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cycle Plan use?

Cycle Plan is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cycle Plan use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cycle Plan?

Skills that share tags, products or a category with Cycle Plan: User Story Writer (deanpeters/Product-Manager-Skills, 7.2k stars), Game Changing Features (openstatusHQ/data-table-filters, 2.3k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Convex Create Component (spokvulcan/poker-planning, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cycle Plan?

joa23 (a GitHub user) maintains it in joa23/linear-cli, which has 144 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 13, 2026.

Source: joa23/linear-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Cycle Plan

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Cycle Plan Skill - Sprint Planning

When to Use

Process

CRITICAL: Setup First

Velocity Analysis

Planning Output

Commands Used

Key Learnings

Best Practices

Files

Compare with similar skills

Similar skills

More from joa23/linear-cli

Related

Questions about Cycle Plan