paperclip-create-agent

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.

70,095stars13,009forksUpdated 6/12/2026

Documentation #ai-agent #configuration #documentation #governance #paperclip #agent-creation

Security Assessment

Safe(90/100)

Detected risks:

Sensitive File Access([references/agents/securityengineer.md] .env)

Security Score90/100

About paperclip-create-agent

The `paperclip-create-agent` skill enables users to create and hire new agents within the Paperclip platform while adhering to governance and company policies. It is designed to provide a structured workflow for configuring, reviewing, and submitting new agent requests, ensuring that all agent hires comply with company standards and operational protocols. This skill addresses the challenge of onboarding agents consistently, particularly when multiple templates, adapters, and configuration options exist, and ensures that roles are accurately defined and permissions properly assigned.

The main features of this skill include the ability to inspect adapter configurations for the current Paperclip instance, compare existing agent configurations to follow company conventions, select and adapt templates or construct new role instructions, discover allowed agent icons, and draft comprehensive hire configurations. Users can specify role information, reporting lines, adapter types, desired skills, runtime configurations, and sensitive workflow handling. Additionally, the skill supports managing instructions bundles, execution contracts for coding or actionable agents, and explicit governance justifications for any expanded access capabilities. The step-by-step workflow emphasizes identity verification, adapter inspection, template selection, and careful drafting of agent configurations with detailed operational parameters.

This skill is primarily used by individuals with board access or explicit agent creation permissions, including managers, system administrators, and HR/technical leads responsible for hiring AI agents. Common use cases include hiring new agents for specialized roles, adapting existing templates for new positions, reviewing and aligning agent configurations with company standards, and ensuring compliance for roles that may access sensitive data or external systems. It is especially valuable in organizations that need structured governance and audit trails for agent creation, providing a clear and repeatable process for creating compliant, functional, and well-documented agents within Paperclip.

FAQ

Who can use the paperclip-create-agent skill?

Users need either board access or the `can_create_agents=true` permission. Without this, requests must be escalated to the CEO or board.

What types of templates can be used when creating a new agent?

You can use an exact template matching the role, an adjacent template adapted from a similar role, or a generic fallback baseline role guide if no templates match.

How do I verify adapter configuration for my Paperclip instance?

Use the provided API endpoints to inspect the general agent configuration and the specific adapter configuration you plan to use, ensuring compatibility with your hire.

What requirements exist for agent icons?

Icons must be selected from the allowed agent icons list retrieved via the Paperclip API to maintain company convention and consistency.

Are there limitations on agent capabilities or access?

Any desired skills or adapter settings that expand browser access, external system reach, filesystem scope, or secret-handling must be justified in the hire comment. Confidential workflows must be confirmed for sensitive roles.