Skip to content
Get packs

Create Paperclip Bundled Skill

Turn a tweet, idea or existing skill into a reviewed Paperclip catalog PR

Source Download skill
Repository
paperclipai/paperclip
Stars
110,078
Licence
MIT
Files
3 files

What it does

This is a guide for an AI agent working on the Paperclip project. It tells the agent how to take source material such as a tweet, task description or blog post, first search for an existing skill to reuse, then either reference an external skill pinned to a specific commit or write a new local one. It also covers choosing a category and slug, adding worked examples, regenerating the manifest and opening a pull request. Based on the visible SKILL.md, it directs the agent to run shell tools such as gh (GitHub CLI), grep and xc (an X/Twitter client), and to fetch web pages and READMEs. The SKILL.md is cut off mid-example, and the two example files were not provided, so the later steps are not fully verified.

Great for

  • Developers and maintainers contributing skills to the Paperclip skills catalog
  • Teams that want an agent to package a shared procedure as a reviewable pull request
  • Anyone who wants to pin and attribute an existing public SKILL.md from GitHub inside Paperclip

Skip it if

  • Company-private skills, which the SKILL.md says belong in the company's own library through the Skills UI or API, not the shipped catalog
  • Someone outside the Paperclip repository who only wants a general-purpose skill, since the steps assume Paperclip's catalog layout and build tooling
  • Use on a fork or environment with live X or GitHub credentials without review, because the agent will run commands and open PRs under those accounts

Try asking

  • “Turn this tweet into a Paperclip skill: https://x.com/example/status/123”
  • “Find an existing GitHub skill for code review checklists and add it to the catalog as an external reference”
  • “Make a new optional skill that teaches agents to write better commit messages, and open a PR”
  • “Bundle the repo skill in .agents/skills/ into the optional catalog with examples”
Step-by-step guide: how to use Create Paperclip Bundled SkillInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 3 original files, the MIT licence and an attribution note.

    create-paperclip-bundled-skill.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-paperclip-bundled-skill.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-paperclip-bundled-skill.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Let the agent run the FIND step first and check existing catalog entries, so you avoid duplicate slugs that fail the build
  • Keep kind as optional unless a human or board member explicitly asks for bundled, since bundled skills ship to every company by default
  • Review the PR description for source attribution and for whether the agent authored the procedure itself

What's inside

  • examples/external-reference.md
  • examples/new-local-skill.md
  • SKILL.md

Redistributed unmodified from paperclipai/paperclip under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.