Agent skill

Task Planning

by paperclipai in paperclipai/paperclip

Write or revise a useful Paperclip plan with a clear outcome and verification.

MITAuto-check passedAgent Workflows

Install Task Planning

skills CLI
$ npx skills add paperclipai/paperclip --skill task-planning -a claude-code

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

GitHub CLI
$ gh skill install paperclipai/paperclip task-planning --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/paperclipai/paperclip.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/skills-catalog/catalog/bundled/paperclip-operations/task-planning .claude/skills/task-planning && 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/

Facts

Skill name
task-planning
GitHub stars
99k
Token cost
~380 tokens
SKILL.md length
169 words
Files
1
Skills in repo
60
Repo updated
First seen
Licence
MIT

At a glance

Write or revise a useful Paperclip plan with a clear outcome and verification.

  • A plan is requested
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Uncertainty needs resolving before execution

What it does

Task Planning is an agent skill from paperclipai/paperclip. Write or revise a useful Paperclip plan with a clear outcome and verification. Use when a plan is requested or uncertainty needs resolving before execution.

Its SKILL.md is about 380 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 Agent Workflows, covering Planning. The repository describes itself as: The open-source app everyone uses to manage agents at work. The licence is MIT.

When your agent uses it

  • A plan is requested
  • Uncertainty needs resolving before execution

Example prompts

  • “/task-planning”

What it can do on your machine

Read from SKILL.md and the folder at commit 5717523. 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.

    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

Task Planning loads about 380 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 169 words of instructions outside code blocks.

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

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 paperclipai/paperclip at commit 5717523, republished under its MIT licence (© paperclipai). 169 words, ~380 tokens.

Download SKILL.mdSave it as .claude/skills/task-planning/SKILL.md (or your agent's skills folder).
name
task-planning
description
Write or revise a useful Paperclip plan with a clear outcome and verification. Use when a plan is requested or uncertainty needs resolving before execution.
key
paperclipai/bundled/paperclip-operations/task-planning
recommendedForRoles
manager, engineer, product
tags
paperclip, planning, issues, delegation

Task planning

Plan only as much as the work needs. If execution is authorized and the next step is small and clear, do it. A request for a plan alone does not require child tasks or a new approval gate.

Describe the intended outcome, relevant constraints, chosen approach, and how to verify success. Include uncertainties or decisions that affect execution. Use the user's preferred format; keep implementation steps within one owner's task unless another owner, useful parallel output, dependency, or independent review warrants separate work.

Save a requested plan as the issue document with key plan. Update its current revision instead of duplicating it, and link the saved document in your response. Use the native document tools when available; legacy agents follow the paperclip skill's document and planning API mechanics.

Respect planning mode and explicit approval requests. When approval is required, request confirmation of the latest plan revision and wait for that decision. After acceptance, execute cohesive work on the current ordinary task. Use paperclip-converting-plans-to-tasks when delegation is justified.

© paperclipai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/skills-catalog/catalog/bundled/paperclip-operations/task-planning of paperclipai/paperclip.

Open the folder on GitHubat commit 5717523

Compare with similar skills

Task Planning 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.

Task Planning compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Task Planning this skillpaperclipai/paperclip99k—~380Automated safety check: PassMIT
Executing Plans Inlineobra/superpowers296k2 repos~5.1kAutomated safety check: PassMIT
Interview Meaddyosmani/agent-skills103k6 repos~3.8kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
Writing Plansgeeksblabla/stateofdev.ma16357 repos~661Automated safety check: PassNone
Subagent Driven DevelopmentAsvarox/allkaraoke26138 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    296k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    103k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed
  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed
  • Writing Plans

    geeksblabla/stateofdev.ma

    A skill your agent uses when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file…

    163 GitHub starsUsed in 57 repos~661 tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 38 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Planning With Files

    jd-opensource/JoySafeter

    Implements Manus-style file-based planning for complex tasks.

    313 GitHub starsUsed in 19 repos~1.8k tokens
    Agent WorkflowsAuto-check: notes

More from paperclipai/paperclip

All 60 skills in this repo
  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    99k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    Interact with the Paperclip control plane API for task coordination and governance.

    99k GitHub stars~9.6k tokensUpdated today
    Auto-check passed
  • Paperclip

    paperclipai/paperclip

    A skill your agent uses for Paperclip-managed tasks and heartbeats: reading task context, delivering task documents or files, updating completion or blockers, coordinating or delegating work, and…

    99k GitHub stars~17k tokensUpdated today
    Auto-check passed
  • Design Guide

    paperclipai/paperclip

    Paperclip UI design system guide for building consistent, reusable frontend components.

    99k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    99k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Paperclip Create Agent

    paperclipai/paperclip

    Create new agents in Paperclip with governance-aware hiring.

    99k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed

Categories

Questions about Task Planning

What does Task Planning do?

Write or revise a useful Paperclip plan with a clear outcome and verification. Task Planning is an agent skill from paperclipai/paperclip. Write or revise a useful Paperclip plan with a clear outcome and verification.

When should I use Task Planning?

Task Planning fits situations like: A plan is requested; uncertainty needs resolving before execution.

How do I install Task Planning in Claude Code?

Run `npx skills add paperclipai/paperclip --skill task-planning -a claude-code`. Or copy the skill folder (packages/skills-catalog/catalog/bundled/paperclip-operations/task-planning in paperclipai/paperclip) into .claude/skills/task-planning in your project. Claude Code loads it when a task matches its description.

How do I install Task Planning in Codex?

Run `npx skills add paperclipai/paperclip --skill task-planning -a codex`. Or copy the skill folder (packages/skills-catalog/catalog/bundled/paperclip-operations/task-planning in paperclipai/paperclip) into .agents/skills/task-planning in your project. Codex loads it when a task matches its description.

Can I use Task Planning 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 paperclipai/paperclip --skill task-planning -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/task-planning, .gemini/skills/task-planning, .github/skills/task-planning and .opencode/skills/task-planning in your project.

What does Task Planning need to run?

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

Does Task Planning 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 Task Planning 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 Task Planning use?

Task Planning 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 Task Planning use?

About 380 tokens (SKILL.md is roughly 1.5k 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 Task Planning?

Skills that share tags, products or a category with Task Planning: Executing Plans Inline (obra/superpowers, 296k stars), Interview Me (addyosmani/agent-skills, 103k stars), OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars) and Writing Plans (geeksblabla/stateofdev.ma, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Task Planning?

paperclipai (a GitHub organization) maintains it in paperclipai/paperclip, which has 98,537 GitHub stars. The repository holds 60 skills in this directory. The repository was last updated on October 8, 2026.

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