Skip to content
Get packs

Set Up Code Maintenance Bot

Configures a Paperclip agent and scheduled routine that runs a code-maintenance skill and opens PRs.

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

What it does

This skill guides an AI agent through setting up an automated maintenance bot inside a Paperclip instance (an agent-orchestration platform). It asks which Paperclip instance, company, agent, repository, maintenance skill, schedule and limits to use, then creates a paused routine with a written task description and enables it only after readiness checks. Once active, the bot can periodically apply a chosen maintenance task, such as test auditing, docs upkeep, dependency updates or refactoring, and open pull requests for review.

Great for

  • Engineering teams who want nightly or scheduled code-maintenance PRs reviewed by humans
  • Paperclip users who already run agents and want a bounded, inspectable maintenance routine
  • Maintainers who want a checklist-driven setup that avoids duplicate scheduled jobs

Skip it if

  • Anyone wanting unattended merges: the skill proposes no automatic merging, but it does grant write access to repositories and PR credentials, so review every change before granting access
  • Users without a Paperclip instance, since the skill only configures that platform and cannot run standalone
  • Teams expecting the skill to judge code quality itself: the actual maintenance judgment comes from whichever separate maintenance skill is selected

Try asking

  • “Set up a nightly test-audit bot for my repo on the Paperclip instance at my company URL”
  • “Draft a setup plan for a weekly dependency-maintenance routine without provisioning anything yet”
  • “Create a webhook-triggered documentation upkeep bot that opens draft PRs for review”
Step-by-step guide: how to use Set Up Code Maintenance BotInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    setup-code-maintenance-bot.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip setup-code-maintenance-bot.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip setup-code-maintenance-bot.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

  • Review the drafted routine description and PR limits before approving activation, and start with a paused routine and a manual trial.
  • Keep repository credentials and AI connection credentials separate and scoped to the minimum needed.
  • Set a per-run cost limit and an outstanding-PR cap so the bot cannot pile up work.

What's inside

  • agents/openai.yaml
  • references/paperclip-api.md
  • references/run-instructions.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.