diff --git a/packages/paperclip-runner/generated/capability/capabilities.yaml b/packages/paperclip-runner/generated/capability/capabilities.yaml
index bd855662a4c..2268d03db45 100644
--- a/packages/paperclip-runner/generated/capability/capabilities.yaml
+++ b/packages/paperclip-runner/generated/capability/capabilities.yaml
@@ -218,54 +218,54 @@
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:571",
+      "id": "skill:skills/paperclip/SKILL.md:567",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L571:comment-style-required",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L567:comment-style-required",
       "heading": "Comment Style (Required)",
       "primaryDisposition": "always_agent_tool",
       "semanticOperation": "report_progress",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:603",
+      "id": "skill:skills/paperclip/SKILL.md:599",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L603:update",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L599:update",
       "heading": "Update",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:613",
+      "id": "skill:skills/paperclip/SKILL.md:609",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L613:planning-required-when-planning-requested",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L609:planning-required-when-planning-requested",
       "heading": "Planning (Required when planning requested)",
       "primaryDisposition": "always_agent_tool",
       "semanticOperation": "write_document",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:646",
+      "id": "skill:skills/paperclip/SKILL.md:642",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L646:key-endpoints-hot-routes",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L642:key-endpoints-hot-routes",
       "heading": "Key Endpoints (Hot Routes)",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:675",
+      "id": "skill:skills/paperclip/SKILL.md:671",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L675:searching-issues",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L671:searching-issues",
       "heading": "Searching Issues",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/SKILL.md:685",
+      "id": "skill:skills/paperclip/SKILL.md:681",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/SKILL.md#L685:full-reference",
+      "sourceAnchor": "skills/paperclip/SKILL.md#L681:full-reference",
       "heading": "Full Reference",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
@@ -634,268 +634,268 @@
     {
       "id": "skill:skills/paperclip/references/api-reference.md:691",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:escalation",
-      "heading": "Escalation",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L691:handling-blockers",
+      "heading": "Handling blockers",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:701",
+      "id": "skill:skills/paperclip/references/api-reference.md:703",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L701:company-context",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L703:company-context",
       "heading": "Company Context",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:713",
+      "id": "skill:skills/paperclip/references/api-reference.md:715",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L713:company-branding-ceo-board",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L715:company-branding-ceo-board",
       "heading": "Company Branding (CEO / Board)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:733",
+      "id": "skill:skills/paperclip/references/api-reference.md:735",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L733:openclaw-invite-prompt-ceo",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L735:openclaw-invite-prompt-ceo",
       "heading": "OpenClaw Invite Prompt (CEO)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:752",
+      "id": "skill:skills/paperclip/references/api-reference.md:754",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L752:setting-agent-instructions-path",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L754:setting-agent-instructions-path",
       "heading": "Setting Agent Instructions Path",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:785",
+      "id": "skill:skills/paperclip/references/api-reference.md:787",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L785:project-setup-create-workspace",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L787:project-setup-create-workspace",
       "heading": "Project Setup (Create + Workspace)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:809",
+      "id": "skill:skills/paperclip/references/api-reference.md:811",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L809:option-a-one-call-create-with-workspace",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L811:option-a-one-call-create-with-workspace",
       "heading": "Option A: One-call create with workspace",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:828",
+      "id": "skill:skills/paperclip/references/api-reference.md:830",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L828:option-b-two-calls-project-first-then-workspace",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L830:option-b-two-calls-project-first-then-workspace",
       "heading": "Option B: Two calls (project first, then workspace)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:857",
+      "id": "skill:skills/paperclip/references/api-reference.md:859",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L857:governance-and-approvals",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L859:governance-and-approvals",
       "heading": "Governance and Approvals",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:861",
+      "id": "skill:skills/paperclip/references/api-reference.md:863",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L861:requesting-a-hire-management-only",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L863:requesting-a-hire-management-only",
       "heading": "Requesting a hire (management only)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:926",
+      "id": "skill:skills/paperclip/references/api-reference.md:928",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L926:ceo-strategy-approval",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L928:ceo-strategy-approval",
       "heading": "CEO strategy approval",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:935",
+      "id": "skill:skills/paperclip/references/api-reference.md:937",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L935:questions-and-waiting-for-human-input",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L937:questions-and-waiting-for-human-input",
       "heading": "Questions and waiting for human input",
       "primaryDisposition": "always_agent_tool",
       "semanticOperation": "request_human_input",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1032",
+      "id": "skill:skills/paperclip/references/api-reference.md:1034",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1032:issue-thread-confirmations",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1034:issue-thread-confirmations",
       "heading": "Issue-thread confirmations",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1090",
+      "id": "skill:skills/paperclip/references/api-reference.md:1092",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1090:checkbox-confirmations",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1092:checkbox-confirmations",
       "heading": "Checkbox confirmations",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1205",
+      "id": "skill:skills/paperclip/references/api-reference.md:1207",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1205:item-verdict-requests",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1207:item-verdict-requests",
       "heading": "Item verdict requests",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1315",
+      "id": "skill:skills/paperclip/references/api-reference.md:1317",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1315:checking-approval-status",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1317:checking-approval-status",
       "heading": "Checking approval status",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1321",
+      "id": "skill:skills/paperclip/references/api-reference.md:1323",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1321:approval-follow-up-requesting-agent",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1323:approval-follow-up-requesting-agent",
       "heading": "Approval follow-up (requesting agent)",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1339",
+      "id": "skill:skills/paperclip/references/api-reference.md:1341",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1339:issue-lifecycle",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1341:issue-lifecycle",
       "heading": "Issue Lifecycle",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1369",
+      "id": "skill:skills/paperclip/references/api-reference.md:1371",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1369:error-handling",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1371:error-handling",
       "heading": "Error Handling",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1383",
+      "id": "skill:skills/paperclip/references/api-reference.md:1385",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1383:full-api-reference",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1385:full-api-reference",
       "heading": "Full API Reference",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1385",
+      "id": "skill:skills/paperclip/references/api-reference.md:1387",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1385:agents",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1387:agents",
       "heading": "Agents",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1406",
+      "id": "skill:skills/paperclip/references/api-reference.md:1408",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1406:issues-tasks",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1408:issues-tasks",
       "heading": "Issues (Tasks)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1446",
+      "id": "skill:skills/paperclip/references/api-reference.md:1448",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1446:companies-projects-goals",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1448:companies-projects-goals",
       "heading": "Companies, Projects, Goals",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1470",
+      "id": "skill:skills/paperclip/references/api-reference.md:1472",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1470:routines",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1472:routines",
       "heading": "Routines",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1486",
+      "id": "skill:skills/paperclip/references/api-reference.md:1488",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1486:approvals-costs-activity-dashboard",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1488:approvals-costs-activity-dashboard",
       "heading": "Approvals, Costs, Activity, Dashboard",
       "primaryDisposition": "control_plane_owned",
       "semanticOperation": "runtime_reconciliation",
       "expectedMockState": "runtime_decision_record"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1508",
+      "id": "skill:skills/paperclip/references/api-reference.md:1510",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1508:secrets",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1510:secrets",
       "heading": "Secrets",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1521",
+      "id": "skill:skills/paperclip/references/api-reference.md:1523",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1521:agent-secret-proposals",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1523:agent-secret-proposals",
       "heading": "Agent secret proposals",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1574",
+      "id": "skill:skills/paperclip/references/api-reference.md:1576",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1574:re-bind-an-existing-secret-under-a-new-path-no-secret-id",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1576:re-bind-an-existing-secret-under-a-new-path-no-secret-id",
       "heading": "Re-bind an existing secret under a new path (no secret ID)",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1621",
+      "id": "skill:skills/paperclip/references/api-reference.md:1623",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1621:agent-secret-access",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1623:agent-secret-access",
       "heading": "Agent secret access",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
       "expectedMockState": "operation_result"
     },
     {
-      "id": "skill:skills/paperclip/references/api-reference.md:1661",
+      "id": "skill:skills/paperclip/references/api-reference.md:1663",
       "kind": "skill_heading",
-      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1661:common-mistakes",
+      "sourceAnchor": "skills/paperclip/references/api-reference.md#L1663:common-mistakes",
       "heading": "Common Mistakes",
       "primaryDisposition": "optional_agent_tool",
       "semanticOperation": "scoped_discovery",
diff --git a/packages/paperclip-runner/generated/capability/capability-contract.md b/packages/paperclip-runner/generated/capability/capability-contract.md
index 9b833e921a1..68c9ba792e4 100644
--- a/packages/paperclip-runner/generated/capability/capability-contract.md
+++ b/packages/paperclip-runner/generated/capability/capability-contract.md
@@ -5,6 +5,6 @@ Generated by `scripts/generate-capability-contract.mjs`; do not edit generated f
 - Skill/reference headings: 156
 - Legacy MCP tools: 42
 - Eval cases: 106 across 16 groups
-- Deterministic content SHA-256: `5a87f905c451fb79ec5d5fc9a961d3cbc4ba96c8486265088b5da2fda30e4831`
+- Deterministic content SHA-256: `3f87a97ebaca6713f8586b11781cee582c6ae9af8dff452f2746302e6f079197`
 
 Every row has exactly one primary disposition, a source anchor, a semantic operation, and a mock-state expectation.