Skip to content
Get packs

External Bot Integration Builder

Guides building and testing external chat-style bots (like Dot) as Paperclip participants

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

What it does

When installed, the agent follows a detailed workflow for connecting an external AI bot that runs outside Paperclip to Paperclip, so Paperclip can assign it work and the bot can start governed work from its own conversation. It walks through defining the release goals, proving the provider connection, reusing Paperclip's existing execution runner, designing a watched onboarding flow, and qualifying the result with specific tests and deployment checks. It is a process guide for engineers rather than a tool that acts on its own.

Great for

  • Engineers at Paperclip or teams building a similar external bot integration
  • Developers who need a checklist for testing reconnection, recovery, and cleanup of bot integrations
  • Maintainers reviewing whether a bot integration meets the project's qualification bar

Skip it if

  • Users who only want to chat with an existing bot, since this skill is for building integrations, not using them
  • Teams integrating a CLI tool or an app-only connector, which the SKILL.md says should use their own existing skills
  • Anyone without access to the Paperclip repository, since the references depend on its internal code, PRs and runner artifacts

Try asking

  • “Build an external bot integration for a new chat provider in Paperclip”
  • “Qualify the Dot bot integration end to end, including recovery after a controller restart”
  • “Review an onboarding flow for a bot invitation and list the tests still needed before release”
  • “Set up a test environment for a bot integration and document the resources it owns”
Step-by-step guide: how to use External Bot Integration BuilderInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    create-external-bot-integration.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip create-external-bot-integration.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip create-external-bot-integration.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

  • Point the agent at a specific repository checkout and revision so it reuses current code instead of recreating merged work
  • Ask for the release contract matrix first, then use it to decide which conformance tests to run
  • Verify provider API details yourself, since the references are dated evidence and may be out of date

What's inside

  • agents/openai.yaml
  • references/conformance-tests.md
  • references/dot-case-study.md
  • references/onboarding-and-prompts.md
  • references/release-contract.md
  • references/runner-architecture.md
  • references/troubleshooting-and-deployment.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.