docs: document agent instructions path API in skill references

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

skills/paperclip/SKILL.md

@@ -153,6 +153,32 @@ pls show the costs in either token or dollars on the /issues/{id} page. Make a p
 
 \*make sure to have a newline after/before your <plan/> tags
 
+## Setting Agent Instructions Path
+
+Use the dedicated route instead of generic `PATCH /api/agents/:id` when you need to set an agent's instructions markdown path (for example `AGENTS.md`).
+
+```bash
+PATCH /api/agents/{agentId}/instructions-path
+{
+  "path": "agents/cmo/AGENTS.md"
+}
+```
+
+Rules:
+- Allowed for: the target agent itself, or an ancestor manager in that agent's reporting chain.
+- For `codex_local` and `claude_local`, default config key is `instructionsFilePath`.
+- Relative paths are resolved against the target agent's `adapterConfig.cwd`; absolute paths are accepted as-is.
+- To clear the path, send `{ "path": null }`.
+- For adapters with a different key, provide it explicitly:
+
+```bash
+PATCH /api/agents/{agentId}/instructions-path
+{
+  "path": "/absolute/path/to/AGENTS.md",
+  "adapterConfigKey": "yourAdapterSpecificPathField"
+}
+```
+
 ## Key Endpoints (Quick Reference)
 
 | Action               | Endpoint                                                                                   |
@@ -167,6 +193,7 @@ pls show the costs in either token or dollars on the /issues/{id} page. Make a p
 | Create subtask       | `POST /api/companies/:companyId/issues`                                                    |
 | Create project       | `POST /api/companies/:companyId/projects`                                                  |
 | Create project workspace | `POST /api/projects/:projectId/workspaces`                                             |
+| Set instructions path | `PATCH /api/agents/:agentId/instructions-path`                                            |
 | Release task         | `POST /api/issues/:issueId/release`                                                        |
 | List agents          | `GET /api/companies/:companyId/agents`                                                     |
 | Dashboard            | `GET /api/companies/:companyId/dashboard`                                                  |