paperclip-create-agent

Create and submit governance-aware agent hire requests in Paperclip via its REST API.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/Douglas-v/strategic-ai-paperclip-lab --skill paperclip-create-agent-douglas-v
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperclip-create-agent
Source: https://github.com/Douglas-v/strategic-ai-paperclip-lab/tree/main/paperclip/skills/paperclip-create-agent
Command: npx skills add https://github.com/Douglas-v/strategic-ai-paperclip-lab --skill paperclip-create-agent-douglas-v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hiring a new agent in a Paperclip company involves many easy-to-miss steps: discovering adapter configuration, matching company conventions, drafting a high-quality AGENTS.md instruction bundle, and routing the hire through board approval. This Skill turns that into a repeatable, auditable workflow so every hire is consistent, least-privilege, and governance-compliant. ## Core Features & Use Cases - Guided hiring workflow: Walks through identity confirmation, adapter discovery, existing-config comparison, icon selection, draft config, and hire submission via the Paperclip API. - Instruction template library: Ships ready-made AGENTS.md templates for Coder, QA, UX Designer, and Security Engineer roles, plus a baseline role guide and decision flow for exact, adjacent, or from-scratch drafting. - Pre-submit quality checklist: A draft-review checklist covering identity, role clarity, lenses, governance fields, and least-privilege safety before any hire request is sent. - Use Case: Your board asks you to hire a Backend Performance Engineer. You adapt the Coder template with a focused performance lens set, run the checklist, and submit the hire request with a source issue link and approval tracking. ## Quick Start Ask the agent to hire a new QA engineer for your Paperclip company using the paperclip-create-agent skill, and it will discover the adapter config, draft the instructions from the QA template, and submit the hire request for board approval.

Frequently Asked Questions about paperclip-create-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new agent in Paperclip?

Use the guided workflow: confirm your identity via GET /api/agents/me, discover adapter configuration from /llms/agent-configuration.txt, draft the agent config and AGENTS.md instructions, then POST to /api/companies/:companyId/agent-hires. The hire enters pending_approval until the board approves it.

What permission do I need to hire agents in Paperclip?

You need either board access or the agent permission can_create_agents=true in your company. Without it, the workflow directs you to escalate the request to your CEO or board.

How do I write AGENTS.md instructions for a new agent role?

Pick one of three paths: copy an exact template from references/agents/ (Coder, QA, UX Designer, Security Engineer), adapt the closest adjacent template, or build from scratch using the baseline role guide. State which path you took in the hire comment for auditability.

Should I enable timer heartbeats for a new Paperclip agent?

No, leave runtimeConfig.heartbeat.enabled set to false by default. Only enable a timer heartbeat with an intervalSec when the role genuinely needs scheduled recurring work, and justify it in the hire comment.

What happens after I submit an agent hire request?

The API returns an approval object and the agent enters pending_approval status, where it cannot run heartbeats or receive assignments. When the board approves, the agent transitions to idle; if rejected, it is terminated.

Why was my Paperclip agent hire request rejected?

Common rejection causes include unreplaced placeholders like {{companyName}}, missing sourceIssueId or icon, vague capabilities text, and unjustified permission expansion in desiredSkills or adapter config. Run the draft-review checklist before submitting to catch these.