Name: paperclip-create-agent
Author: paperclipai

Create new agents in Paperclip with governance-aware hiring. Use when you need to inspect adapter configuration options, compare existing agent configs, draft a new agent prompt/config, and submit a hire request.

Paperclip Create Agent Skill Use this skill when you are asked to hire/create an agent. Preconditions You need either: board access, or agent permission can create agents=true in your company If you do not have this permission, keep the current task assigned to yourself and identify the missing hiring authority. A CEO or manager title does not grant hiring permission. Do not reassign the task or create an escalation task to bypass the denial. Use the applicable approval flow when available; otherwise save a human input interaction on the current task with resolverPolicy: "human only" and continuationPolicy: "wake assignee" , then leave it in review . Use the complete human input payload in the paperclip skill; when the requesting user owns the decision, address it with their actual addresseeUserId . A human answer does not itself grant permission: recheck authorization before any hire. Workflow Choose the API transport On Paperclip Runner , use the advertised Paperclip tools. Use get task context and list agents for identity and team context, then search api to discover the configuration, instruction template, icon, and agent hires endpoints used below. Call the discovered operations with call api ; the server supplies company and authentication context. Read the returned schemas before drafting the hire. The shell examples below apply to adapters that receive PAPERCLIP API URL and PAPERCLIP API KEY . Paperclip Runner does not supply those variables. Do not search workspace files for a server address or credentials to recreate that path. If search api / call api are unavailable, report that hiring requires the operator to enable runner API tools for this company. Preserve the proposed hire in the conversation; do not claim an agent was created or substitute a temporary subagent for the requested permanent hire. 1. Confirm identity and company context 2. Discover adapter configuration for this Paperclip instance 3. Compare existing agent configurations Note naming, icon, reporting line, and adapter conventions the company already follows. 4. Describe the role Use a short role paragraph for a new agent: its identity and the responsibility it owns. The [role examples](references/agent instruction templates.md) are optional starting points; for other roles, use the [baseline role guide](references/baseline role guide.md). Company specific instructions supplied by the requester take precedence. Do not expand a role description into a generic operating manual. The harness supplies Paperclip coordination, skill discovery, and task lifecycle guidance; repository instructions and installed skills carry applicable work procedures. Avoid adding heartbeat pointers, execution contracts, mandatory per touch comments, fixed reviewer routes, or catalogs of domain concepts to the hire's instructions. Keep reporting lines in reportsTo , capabilities in capabilities , and skills in desiredSkills . Add instruction detail only for a concrete company or role requirement that those fields, the task, repository instructions, or installed skills do not already express. 5. Discover allowed agent icons 6. Draft the new hire config role / title / name icon (required in practice; pick from /llms/agent icons.txt ) reporting line ( reportsTo ) adapter type desiredSkills from the company skill library when this role needs installed skills on day one if any desiredSkills or adapter settings expand browser access, external system reach, filesystem scope, or secret handling capability, justify each one in the hire comment adapter and runtime config aligned to this environment leave timer heartbeats off by default; only set runtimeConfig.heartbeat.enabled=true with an intervalSec when the role genuinely needs scheduled recurring work or the user explicitly asked for it if the role may handle private advisories or sensitive disclosures, confirm a confidential workflow exists first (dedicated skill or documented manual process) capabilities when supplying role instructions from step 4, send them as top level instructionsBundle.files["AGENTS.md"] for managed bundle adapters. Otherwise use the server default. Do not set adapterConfig.promptTemplate or bootstrapPromptTemplate for new agents. source issue linkage ( sourceIssueId or sourceIssueIds ) when this hire came from an issue 7. Review the draft against the quality checklist Before submitting, walk the draft review checklist end to end and fix any item that does not pass: skills/paperclip create agent/references/draft review checklist.md 8. Submit hire request 9. Handle governance state if the response has approval , the hire is pending approval monitor and discuss on the approval thread when the board approves, you will be woken with PAPERCLIP APPROVAL ID ; read linked issues and close/comment follow up If the approval already exists and needs manual linking to the issue: After approval is granted, run this follow up loop: For each linked issue, either: close it if the approval resolved the request, or comment in markdown with links to the approval and next actions. References Optional role examples: skills/paperclip create agent/references/agent instruction templates.md Individual role templates: skills/paperclip create agent/references/agents/ Short role drafting guide: skills/paperclip create agent/references/baseline role guide.md Pre submit draft review checklist: skills/paperclip create agent/references/draft review checklist.md Endpoint payload shapes and full examples: skills/paperclip create agent/references/api reference.md Harness and runner selection Choose the underlying harness in adapterType , such as codex local or claude local . New Codex agents use Paperclip Runner automatically on supported execution targets. New Claude Code agents use Paperclip Runner on Apple Silicon, Intel Mac, Linux x64 and Linux ARM64 with supported glibc. Unknown or unsupported targets retain Legacy. Darwin SSH also defaults to Legacy; native execution requires an explicit runner choice and matching remote assets. The native Claude profile is provider: acpx , acpxAgent: claude , with ordinary model claude opus 5 5 . Explicit models and existing saved runners remain intact. The saved response may therefore have adapterType: paperclip runner and a resolved provider; use that returned configuration for later reads and edits. The optional creation field runner accepts auto , paperclip , or legacy . Use legacy when the user needs CLI settings the native runtime cannot honor. For Claude this includes Chrome, custom commands/state paths, warm process controls, confinement and turn limits. Native Claude uses existing API key and subscription connections. Its configured effort requires provider acknowledgment. Setup and authentication errors never silently change runners. Existing agents keep their saved execution after unrelated edits. An approved hire uses the configuration reviewed by the board. inheritRuntimeFrom: caller keeps its existing runtime inheritance and credential restrictions. CLI equivalents: paperclipai agent create runner legacy payload json ... and paperclipai agent hire runner legacy payload json ... .