Skip to content

Guide · Agent skill

How to use the Paperclip Plan-to-Task Converter agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The Paperclip Plan-to-Task Converter is an agent skill, a packaged set of instructions that an AI agent loads when a request matches its description. This one, named paperclip-converting-plans-to-tasks, teaches an agent to turn an already authorized plan into Paperclip work items without splitting everything into separate tasks. This guide explains what the skill changes, how to install it, how to trigger it and what to check afterward.

Paperclip Plan-to-Task Converterpaperclipai/paperclip · MIT

Quick start

  1. 1Confirm the plan is authorized. Only use the skill on plans that already have approval. It honors existing boundaries and does not grant new permission.
  2. 2Install the ZIP. Unzip the download into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder.
  3. 3Ask in plain language. Request that the agent turn the approved plan into Paperclip work, naming any owners or review needs.
  4. 4Review the task split. Check that small cohesive work stayed in one task and that each separate task has a real reason.
  5. 5Verify dependencies. Confirm that blockedByIssueIds or the native dependency tool saved the prerequisite links correctly.

What the skill makes the agent do

The skill tells the agent to decide whether delegation is justified before creating tasks. Small, cohesive work stays on its current ordinary task with one end-to-end owner. A plan's steps, files and phases do not each automatically become a task.

A separate task is created only for a useful boundary: a different owner or permission, independent parallel output, a real prerequisite, independent review, or substantial follow-up that needs its own lifecycle.

  • Check the available agents before assigning work.
  • Give each delegate enough context and a clear deliverable to work independently.
  • Link dependent tasks with blockedByIssueIds (or the native dependency tool), then verify the saved relationships.
  • Reviewers record findings on their own review task and complete it, including an adverse verdict.
  • Honor existing approval boundaries. Decomposition does not create new approval gates.

Install the skill from the ZIP

Download the ZIP for paperclip-converting-plans-to-tasks from the page where you found this guide, then unzip it. The skill's only file is SKILL.md.

For a personal install, place the unzipped skill folder in ~/.claude/skills/. To share it with one project, place it in that project's .claude/skills/ folder.

Alternatively, upload the ZIP in the Claude apps under Settings → Capabilities → Skills.

  • Personal: ~/.claude/skills/
  • Project: .claude/skills/ inside your project
  • Claude apps: Settings → Capabilities → Skills, then upload the ZIP

Trigger the skill with natural requests

You do not need a special command. The skill's description says to use it when turning an authorized plan into work, so ask for that in plain language. Mention the plan and the outcome you want, such as separate owners, dependencies or a review task.

Be explicit that the plan is already approved. The skill does not grant permission to start work.

  • "Turn the approved migration plan into Paperclip tasks, keeping small steps together."
  • "Split this authorized plan into tasks where a separate owner or real prerequisite requires it, and link the dependencies."
  • "Create a review task for the security reviewer and make sure the findings go on that task."

What you need before you use it

The skill assumes a running Paperclip instance with its task, agent and dependency tools. The instructions depend on Paperclip's task, dependency and approval mechanics, so the skill does little on its own outside that environment.

  • A running Paperclip instance
  • Access to its task and agent tools
  • The dependency field blockedByIssueIds, or the native dependency tool

Safety notes: scripts and network

According to the skill's listing, it runs no scripts and uses no network. It consists of one instruction file, SKILL.md. Its effects come from the Paperclip tools the agent calls, so review the tasks and dependencies the agent creates, especially when assigning work to other agents.

  • Runs scripts: no
  • Uses network: no
  • Files: SKILL.md

Tips for better results

Give the agent the full authorized plan and say which parts are already approved. Ask it to justify each separate task against the boundaries in the skill. After it finishes, check the dependency links, since the skill requires verifying saved relationships. Use dependencies only for true prerequisites so independent work can start immediately.

  • Provide the complete plan and its approval status.
  • Ask why each separate task was created.
  • Confirm dependencies were saved as intended.
  • Keep dependency chains short to avoid needless waiting.

What people use it for

  • Splitting an approved migration plan so each distinct owner gets a task with clear context.
  • Setting up a prerequisite chain where a build task must finish before dependent test tasks start.
  • Creating an independent review task so a reviewer can record a verdict that the implementing owner acts on.
  • Keeping a small, single-owner feature as one task instead of breaking it into steps.

Frequently asked questions

How do I install the paperclip-converting-plans-to-tasks skill?

Download the ZIP from the page, then unzip it into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder. You can also upload the ZIP in the Claude apps under Settings → Capabilities → Skills.

Does this skill require Paperclip?

Yes. The instructions depend on Paperclip's task, dependency and approval mechanics, so it is meant for users running a Paperclip instance with its task, agent and dependency tools.

Is the skill free to use?

The skill is listed under the MIT licence. Check the repository's licence file for the full terms before reuse.

Does the skill run scripts or access the network?

According to its listing, it runs no scripts and uses no network. It consists only of the SKILL.md instruction file.

Will the skill approve or start work on my plan?

No. It honors existing authorization and approval boundaries and does not grant new permission. Decomposition does not create new approval gates.

What is blockedByIssueIds used for?

It is the field the skill uses to set real dependencies between tasks, so dependent work waits for its prerequisite while independent work can start now. The skill also allows the native dependency tool instead.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use this skill if you run Paperclip and want authorized plans split into tasks with clear owners, reviews and dependency chains without over-splitting. Skip it if you do not use Paperclip, or if your plan has not been approved, since the skill assumes both.

Download the skill

Find exactly what
you're looking for