paperclip-create-agent

Name: paperclip-create-agent
Author: getpaperclipai

157kinstalls1forks

How to install paperclip-create-agent?

getpaperclipai/paperclip/paperclip-create-agent

$npx -y skills add getpaperclipai/paperclip --skill paperclip-create-agent

Installs into the current project.

Summary

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.

Files · 1

View on GitHub

SKILL.md

1	# Paperclip Create Agent Skill
2
3	Use this skill when you are asked to hire/create an agent.
4
5	## Preconditions
6
7	Paperclip must already be installed and running. If the server is not up or `PAPERCLIP_API_URL` is unreachable, read `skills/paperclip/references/setup-installation.md` first.
8
9	You need either:
10
11	- board access, or
12	- agent permission `can_create_agents=true` in your company
13
14	If you do not have this permission, escalate to your CEO or board.
15
16	## Workflow
17
18	### 1. Confirm identity and company context
19
20	```sh
21	curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
22	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
23	```
24
25	### 2. Discover adapter configuration for this Paperclip instance
26
27	```sh
28	curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
29	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
30
31	# Then the specific adapter you plan to use, e.g. claude_local:
32	curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt" \
33	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
34	```
35
36	### 3. Compare existing agent configurations
37
38	```sh
39	curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
40	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
41	```
42
43	Note naming, icon, reporting-line, and adapter conventions the company already follows.
44
45	### 4. Choose the instruction source (required)
46
47	This is the single most important decision for hire quality. Pick exactly one path:
48
49	- Exact template — the role matches an entry in the template index. Use the matching file under `references/agents/` as the starting point.
50	- Adjacent template — no exact match, but an existing template is close (for example, a "Backend Engineer" hire adapted from `coder.md`, or a "Content Designer" adapted from `uxdesigner.md`). Copy the closest template and adapt deliberately: rename the role, rewrite the role charter, swap domain lenses, and remove sections that do not fit.
51	- Generic fallback — no template is close. Use the baseline role guide to construct a new `AGENTS.md` from scratch, filling in each recommended section for the specific role.
52
53	Template index and when-to-use guidance:
54	`skills/paperclip-create-agent/references/agent-instruction-templates.md`
55
56	Generic fallback for no-template hires:
57	`skills/paperclip-create-agent/references/baseline-role-guide.md`
58
59	State which path you took in your hire-request comment so the board can see the reasoning.
60
61	### 5. Discover allowed agent icons
62
63	```sh
64	curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
65	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
66	```
67
68	### 6. Draft the new hire config
69
70	- role / title / name
71	- icon (required in practice; pick from `/llms/agent-icons.txt`)
72	- reporting line (`reportsTo`)
73	- adapter type
74	- `desiredSkills` from the company skill library when this role needs installed skills on day one
75	- 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
76	- adapter and runtime config aligned to this environment
77	- 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
78	- if the role may handle private advisories or sensitive disclosures, confirm a confidential workflow exists first (dedicated skill or documented manual process)
79	- capabilities
80	- managed instructions bundle (`AGENTS.md`) for adapters that support it; avoid durable `promptTemplate` config
81	- for coding or execution agents, include the Paperclip execution contract: start actionable work in the same heartbeat; do not stop at a plan unless planning was requested; leave durable progress with a clear next action; use child issues for long or parallel delegated work instead of polling; mark blocked work with owner/action; respect budget, pause/cancel, approval gates, and company boundaries
82	- instruction text such as `AGENTS.md` built from step 4; for local managed-bundle adapters, send this as top-level `instructionsBundle.files["AGENTS.md"]`. Do not set `adapterConfig.promptTemplate` or `bootstrapPromptTemplate` for new agents.
83	- source issue linkage (`sourceIssueId` or `sourceIssueIds`) when this hire came from an issue
84
85	### 7. Review the draft against the quality checklist
86
87	Before submitting, walk the draft-review checklist end-to-end and fix any item that does not pass:
88	`skills/paperclip-create-agent/references/draft-review-checklist.md`
89
90	### 8. Submit hire request
91
92	```sh
93	curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-hires" \
94	-H "Authorization: Bearer $PAPERCLIP_API_KEY" \
95	-H "Content-Type: application/json" \
96	-d '{
97	"name":

People who liked this also viewed

6 picks

Type

paperclip-create-agent

157kinstalls1forks

View on GitHub

How to install paperclip-create-agent?

getpaperclipai/paperclip/paperclip-create-agent

$npx -y skills add getpaperclipai/paperclip --skill paperclip-create-agent

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Paperclip Create Agent Skill
2
3	Use this skill when you are asked to hire/create an agent.
4
5	## Preconditions
6
7	Paperclip must already be installed and running. If the server is not up or `PAPERCLIP_API_URL` is unreachable, read `skills/paperclip/references/setup-installation.md` first.
8
9	You need either:
10
11	- board access, or
12	- agent permission `can_create_agents=true` in your company
13
14	If you do not have this permission, escalate to your CEO or board.
15
16	## Workflow
17
18	### 1. Confirm identity and company context
19
20	```sh
21	curl -sS "$PAPERCLIP_API_URL/api/agents/me" \
22	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
23	```
24
25	### 2. Discover adapter configuration for this Paperclip instance
26
27	```sh
28	curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration.txt" \
29	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
30
31	# Then the specific adapter you plan to use, e.g. claude_local:
32	curl -sS "$PAPERCLIP_API_URL/llms/agent-configuration/claude_local.txt" \
33	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
34	```
35
36	### 3. Compare existing agent configurations
37
38	```sh
39	curl -sS "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-configurations" \
40	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
41	```
42
43	Note naming, icon, reporting-line, and adapter conventions the company already follows.
44
45	### 4. Choose the instruction source (required)
46
47	This is the single most important decision for hire quality. Pick exactly one path:
48
49	- Exact template — the role matches an entry in the template index. Use the matching file under `references/agents/` as the starting point.
50	- Adjacent template — no exact match, but an existing template is close (for example, a "Backend Engineer" hire adapted from `coder.md`, or a "Content Designer" adapted from `uxdesigner.md`). Copy the closest template and adapt deliberately: rename the role, rewrite the role charter, swap domain lenses, and remove sections that do not fit.
51	- Generic fallback — no template is close. Use the baseline role guide to construct a new `AGENTS.md` from scratch, filling in each recommended section for the specific role.
52
53	Template index and when-to-use guidance:
54	`skills/paperclip-create-agent/references/agent-instruction-templates.md`
55
56	Generic fallback for no-template hires:
57	`skills/paperclip-create-agent/references/baseline-role-guide.md`
58
59	State which path you took in your hire-request comment so the board can see the reasoning.
60
61	### 5. Discover allowed agent icons
62
63	```sh
64	curl -sS "$PAPERCLIP_API_URL/llms/agent-icons.txt" \
65	-H "Authorization: Bearer $PAPERCLIP_API_KEY"
66	```
67
68	### 6. Draft the new hire config
69
70	- role / title / name
71	- icon (required in practice; pick from `/llms/agent-icons.txt`)
72	- reporting line (`reportsTo`)
73	- adapter type
74	- `desiredSkills` from the company skill library when this role needs installed skills on day one
75	- 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
76	- adapter and runtime config aligned to this environment
77	- 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
78	- if the role may handle private advisories or sensitive disclosures, confirm a confidential workflow exists first (dedicated skill or documented manual process)
79	- capabilities
80	- managed instructions bundle (`AGENTS.md`) for adapters that support it; avoid durable `promptTemplate` config
81	- for coding or execution agents, include the Paperclip execution contract: start actionable work in the same heartbeat; do not stop at a plan unless planning was requested; leave durable progress with a clear next action; use child issues for long or parallel delegated work instead of polling; mark blocked work with owner/action; respect budget, pause/cancel, approval gates, and company boundaries
82	- instruction text such as `AGENTS.md` built from step 4; for local managed-bundle adapters, send this as top-level `instructionsBundle.files["AGENTS.md"]`. Do not set `adapterConfig.promptTemplate` or `bootstrapPromptTemplate` for new agents.
83	- source issue linkage (`sourceIssueId` or `sourceIssueIds`) when this hire came from an issue
84
85	### 7. Review the draft against the quality checklist
86
87	Before submitting, walk the draft-review checklist end-to-end and fix any item that does not pass:
88	`skills/paperclip-create-agent/references/draft-review-checklist.md`
89
90	### 8. Submit hire request
91
92	```sh
93	curl -sS -X POST "$PAPERCLIP_API_URL/api/companies/$PAPERCLIP_COMPANY_ID/agent-hires" \
94	-H "Authorization: Bearer $PAPERCLIP_API_KEY" \
95	-H "Content-Type: application/json" \
96	-d '{
97	"name":

People who liked this also viewed

6 picks

Type