К основному содержанию
скилл CX Codex

paperclip-create-agent — скилл для Claude Code

Скилл paperclip-create-agent для найма агентов в Paperclip с контролем прав доступа. Проверяет конфигурацию адаптеров, сравнивает настройки существующих агентов, собирает конфиг нового и отправляет заявку на найм.

MIT 3 600 установок ★ 115 688 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add paperclipai/paperclip --skill paperclip-create-agent -a claude-code
Открыть на GitHub

Что делает paperclip-create-agent

Скилл запускает процесс найма агента: проверяет права (can_create_agents или доступ к борду), загружает конфигурацию адаптеров и иконок с сервера Paperclip, анализирует настройки уже нанятых агентов (имена, reportsTo, адаптеры), собирает конфиг для нового агента (роль, иконка, desiredSkills, адаптер, runtimeConfig) и отправляет POST-запрос на /api/companies/{id}/agent-hires. Если компания требует одобрения борда, скилл ставит заявку в статус pending_approval и ждёт решения.

В Paperclip Runner скилл работает через search_api и call_api, в других средах — через curl с PAPERCLIP_API_URL и PAPERCLIP_API_KEY. Без прав на найм агент сохраняет задачу с resolverPolicy: "human_only" и не обходит запрет через делегирование. Heartbeat-таймеры выключены по умолчанию, их включают только для ролей с регулярной фоновой работой.

Скилл не подставляет promptTemplate или bootstrapPromptTemplate в новые конфиги — инструкции роли передаются через instructionsBundle.files["AGENTS.md"] для managed-bundle адаптеров, иначе используется серверный default.

Какие задачи решает

  • Нанять агента с проверкой прав доступа и governance-флоу компании
  • Сравнить конфигурации существующих агентов перед созданием нового
  • Собрать draft-конфиг с адаптером, иконкой, reporting line и skills
  • Отправить hire-запрос в Paperclip API и отследить статус одобрения

Примеры запросов агенту

  • Найми агента CTO с адаптером codex_local, моделью o4-mini, иконкой crown и reporting line на CEO
  • Проверь конфигурации агентов компании и покажи, какие адаптеры используются
  • Создай агента на роль QA Engineer с доступом к скиллу playwright-skill и без heartbeat-таймера

Как установить paperclip-create-agent

1Через Skills CLI (Vercel)

npx skills add paperclipai/paperclip --skill paperclip-create-agent -a claude-code

2Вручную: положить файлы

~/.claude/skills/paperclip-create-agent/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/paperclip-create-agent/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о paperclip-create-agent

Как установить paperclip-create-agent в Claude Code?

Выполни npx skills add paperclipai/paperclip --skill paperclip-create-agent -a claude-code, затем открой ~/.claude/skills/paperclip-create-agent/SKILL.md.

Что делает paperclip-create-agent?

Скилл запускает найм агента в Paperclip: проверяет права, загружает конфигурацию адаптеров и иконок, сравнивает существующие агентские конфиги, собирает draft нового и отправляет hire-запрос. Если компания требует одобрения борда, скилл ждёт его перед финальным созданием.

Что нужно для работы paperclip-create-agent?

Права can_create_agents=true в компании или доступ к борду. В Paperclip Runner скилл использует search_api и call_api, в других средах — переменные PAPERCLIP_API_URL и PAPERCLIP_API_KEY.

Исходный текст

SKILL.md · MIT
---
name: paperclip-create-agent
description: >
  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

```sh
curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"
```

### 2. Discover adapter configuration for this Paperclip instance

```sh
curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

# Then the specific adapter you plan to use, e.g. claude_local:
curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"
```

### 3. Compare existing agent configurations

```sh
curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"
```

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

```sh
curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"
```

### 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

```sh
curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-hires" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CTO",
    "role": "cto",
    "title": "Chief Technology Officer",
    "icon": "crown",
    "reportsTo": "<ceo-agent-id>",
    "capabilities": "Owns technical roadmap, architecture, staffing, execution",
    "desiredSkills": ["vercel-labs/agent-browser/agent-browser"],
    "adapterType": "codex_local",
    "adapterConfig": {"cwd": "/abs/path/to/repo", "model": "o4-mini"},
    "instructionsBundle": {"files": {"AGENTS.md": "You are the CTO..."}},
    "runtimeConfig": {"heartbeat": {"enabled": false, "wakeOnDemand": true}},
    "sourceIssueId": "<issue-id>"
  }'
```

### 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

```sh
curl -sS "$PAPERCLIP_API_URL/api/approvals/<approval-id>" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS -X POST "$PAPERCLIP_API_URL/api/approvals/<approval-id>/comments" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"## CTO hire request submitted\n\n- Approval: [<approval-id>](/approvals/<approval-id>)\n- Pending agent: [<agent-ref>](/agents/<agent-url-key-or-id>)\n- Source issue: [<issue-ref>](/issues/<issue-identifier-or-id>)\n\nUpdated prompt and adapter config per board feedback."}'
```

If the approval already exists and needs manual linking to the issue:

```sh
curl -sS -X POST "$PAPERCLIP_API_URL/api/issues/<issue-id>/approvals" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"approvalId":"<approval-id>"}'
```

After approval is granted, run this follow-up loop:

```sh
curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"

curl -sS "$PAPERCLIP_API_URL/api/approvals/$PAPERCLIP_APPROVAL_ID/issues" \
  -H "Authorization: Bearer $PAPERCLIP_API_KEY"
```

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 ...`.

© paperclipai · MIT · paperclipai/paperclip

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
paperclip-ai-orchestration reason-machines Скилл paperclip-ai-orchestration обучает ассистента управлять платформой Paperclip: разворачивать структуру из ИИ-агентов, ставить им цели и контролировать лимиты расходов. Помогает координировать задачи по расписанию. CX Codex +1 1 500установок sumsub-create-workflow sumsub Скилл sumsub-create-workflow собирает воркфлоу проверки в Sumsub из компактного описания узлов и связей, валидирует черновик и публикует его. Публикация меняет живой трафик — это главное, что нужно знать. CX Codex +1 720установок workflow-create ruvnet Скилл workflow-create для написания рабочих потоков: либо MCP-шаблоны с паузами и одобрениями, либо JS-скрипты с фан-аутом субагентов. Для длительных конвейеров и комплексных аудитов. CX Codex +1 740установок create-phone-number vapi Скилл create-phone-number для Claude Code и Codex: управляет телефонными номерами Vapi через публичный API — создание, импорт, маршрутизация, обновление и проверка номеров для голосовых ассистентов. CX Codex +1 973установок create-meta-prompts Lex Christopherson Скилл create-meta-prompts для Claude Code собирает промпты многоэтапной работы: исследование, план, выполнение. Результат каждого этапа становится входом для следующего. CX Codex +1 ★ 1 988звёзд репо create-skill aeonfun Скилл create-skill берёт описание в одну строку и собирает из него готовый скилл: разбирает запрос, проверяет дубликаты, ищет документацию по API и открывает PR. CX Codex +1 ★ 797звёзд репо

Из того же набора7

paperclip Скилл paperclip для Claude Code помогает агенту выполнять задачи, которыми управляет Paperclip, и отчитываться о ходе работы. Запускается на heartbeat: агент читает контекст, обновляет статус или передаёт документы. CX Codex +1 3 900установок para-memory-files Скилл para-memory-files для сохранения знаний и фактов между сессиями ИИ-кодера. Организует память по методу PARA: проекты, области, ресурсы и архивы в отдельных файлах, с поиском по векторам и ключевым словам. CX Codex +1 1 900установок design-guide Скилл design-guide для Claude Code, Codex, Cursor и других платформ с правилами дизайн-системы Paperclip. CX Codex +1 416установок paperclip-converting-plans-to-tasks Скилл paperclip-converting-plans-to-tasks для Claude Code и Codex превращает утверждённый план в задачи с владельцами и реальными зависимостями. Помогает разделить план для делегирования. CX Codex +1 264установок paperclip-board Скилл paperclip-board для Claude Code помогает управлять компанией Paperclip через диалог. Он подключается для настройки компании, найма агентов, согласования решений и контроля задач и расходов. CX Codex +1 200установок labelhead-artist-momentum MCP-сервер labelhead-artist-momentum для Claude Code показывает динамику трендовых хип-хоп-артистов по четырём культурным измерениям. Анализирует музыкальный momentum. CX Codex +1 ★ 115 688звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой