# Set Up Maintenance Bot

Sets up an agent routine that runs a maintenance skill and opens pull requests.

- Repository: https://github.com/paperclipai/paperclip (109885 stars)
- Category: DevOps
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add paperclipai/paperclip --skill setup-code-maintenance-bot -g -a claude-code -y`
Codex: `npx skills add paperclipai/paperclip --skill setup-code-maintenance-bot -g -a codex -y`
Cursor: `npx skills add paperclipai/paperclip --skill setup-code-maintenance-bot -g -a cursor -y`
Gemini CLI: `npx skills add paperclipai/paperclip --skill setup-code-maintenance-bot -g -a gemini-cli -y`

## Description

Set up a Paperclip agent and routine that applies a selected code-maintenance skill to a repository and opens pull requests. Use for nightly maintenance bots, scheduled code gardening, or webhook-driven maintenance, using an existing agent or a new hire.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Set Up a Code Maintenance Bot

Turn the user's maintenance intent into a runnable Paperclip routine with a
named agent, accessible repository and skill, bounded work, and inspectable PRs.
The maintenance skill supplies the domain judgment: test auditing, documentation
upkeep, dependency maintenance, refactoring, or another chosen task.

If asked only to draft instructions or a setup plan, produce that artifact and
stop before provisioning or running anything. Do not perform the maintenance
while setting up the bot. An immediate trial is a separate choice from scheduling.

## 1. Establish the destination and agent

Start with the instance and agent choices, using answers already supplied:

- **Instance:** show a clickable, verified Paperclip web URL and ask which
  instance to use. If none is known, ask for its URL; never assume localhost,
  the instance used in an earlier task, or the first connected tool.
- **Company:** resolve the company within that instance; ask if ambiguous.
- **Agent:** list accessible, suitable agents with names and links, and offer
  **use an existing agent** or **create a new agent**. Do not silently choose.

Example, after resolving the actual URL: “Use [Paperclip](<verified-web-url>),
company Acme? Which agent should own this: an existing agent or a new one?”

For a new agent, resolve its name, harness/adapter, provider and model, AI
connection/account, execution environment, reporting line, and budget. Present
available compatible choices from the selected instance. Distinguish the AI
connection from repository credentials. For an existing agent, inspect these
settings and preserve them unless the requested maintenance needs an authorized
change. Keep maintenance-specific instructions in the routine, not by replacing
an existing agent's role.

The rest: https://github.com/paperclipai/paperclip/blob/HEAD/.agents/skills/setup-code-maintenance-bot/SKILL.md