@codeam/shared 2.61.22 → 2.61.24

package/dist/index.d.mts

@@ -592,6 +592,11 @@ interface AgentReviewPlan {
     branch: string;
     /** Toolkit integrations the review box is provisioned with (includes `github`). */
     integrationIds: string[];
+    /** Curated skill id(s) attached to this session's purpose (e.g. `code-review`).
+     *  Claude gets them as `~/.codeam/skills.json`; other agents get the instruction
+     *  preamble prepended to `prompt` server-side. The client forwards these into the
+     *  deploy request the same way as `integrationIds`. */
+    skillIds: string[];
 }
 /**
  * Phase-2 agent-review RESULT — POSTed by the review session to
@@ -609,6 +614,50 @@ interface AgentReviewReport {
     findings?: AgentReviewFinding[];
 }
 
+/** Curated skills shipped with the client. Grows over time. */
+type SkillId = 'code-review' | 'resolve-conflicts';
+/** Delivery rails, twin of IntegrationDelivery's mcp/cliEnv. */
+type SkillRail = 'skillFile' | 'instruction';
+/** `skillFile` payload — a Claude-Code SKILL.md bundle (body + optional files). */
+interface SkillFileDelivery {
+    /** The SKILL.md markdown body (WITHOUT frontmatter — frontmatter is generated
+     *  at materialize time with `name` set to the namespaced skill id `codeam-<id>` and
+     *  `description` from the skill definition). */
+    body: string;
+    /** Extra files written alongside SKILL.md: relative path → file contents. */
+    files?: Record<string, string>;
+}
+interface SkillDelivery {
+    skillFile?: SkillFileDelivery;
+    /** Agent-agnostic instruction body, prepended to the composed prompt by the
+     *  backend for agents that do not get the skillFile rail. */
+    instruction?: {
+        body: string;
+    };
+}
+interface SkillDefinition {
+    id: SkillId;
+    name: string;
+    /** One-line; becomes the SKILL.md frontmatter `description` (progressive
+     *  disclosure — this is what sits in the model's context until invoked). */
+    description: string;
+    /** MVP: all curated. 'user' is added with the library fast-follow. */
+    source: 'curated';
+    delivery: SkillDelivery;
+}
+/** What a deploy writes to `~/.codeam/skills.json` — ids only, never content. */
+interface SkillsManifestEntry {
+    id: SkillId;
+}
+interface SkillsManifest {
+    skills: SkillsManifestEntry[];
+}
+
+declare const SKILL_REGISTRY: Record<SkillId, SkillDefinition>;
+declare function isSkillId(id: string): id is SkillId;
+declare function getSkillDefinition(id: string): SkillDefinition | null;
+declare function skillHasRail(id: SkillId, rail: SkillRail): boolean;
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1435,4 +1484,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.d.ts

@@ -592,6 +592,11 @@ interface AgentReviewPlan {
     branch: string;
     /** Toolkit integrations the review box is provisioned with (includes `github`). */
     integrationIds: string[];
+    /** Curated skill id(s) attached to this session's purpose (e.g. `code-review`).
+     *  Claude gets them as `~/.codeam/skills.json`; other agents get the instruction
+     *  preamble prepended to `prompt` server-side. The client forwards these into the
+     *  deploy request the same way as `integrationIds`. */
+    skillIds: string[];
 }
 /**
  * Phase-2 agent-review RESULT — POSTed by the review session to
@@ -609,6 +614,50 @@ interface AgentReviewReport {
     findings?: AgentReviewFinding[];
 }
 
+/** Curated skills shipped with the client. Grows over time. */
+type SkillId = 'code-review' | 'resolve-conflicts';
+/** Delivery rails, twin of IntegrationDelivery's mcp/cliEnv. */
+type SkillRail = 'skillFile' | 'instruction';
+/** `skillFile` payload — a Claude-Code SKILL.md bundle (body + optional files). */
+interface SkillFileDelivery {
+    /** The SKILL.md markdown body (WITHOUT frontmatter — frontmatter is generated
+     *  at materialize time with `name` set to the namespaced skill id `codeam-<id>` and
+     *  `description` from the skill definition). */
+    body: string;
+    /** Extra files written alongside SKILL.md: relative path → file contents. */
+    files?: Record<string, string>;
+}
+interface SkillDelivery {
+    skillFile?: SkillFileDelivery;
+    /** Agent-agnostic instruction body, prepended to the composed prompt by the
+     *  backend for agents that do not get the skillFile rail. */
+    instruction?: {
+        body: string;
+    };
+}
+interface SkillDefinition {
+    id: SkillId;
+    name: string;
+    /** One-line; becomes the SKILL.md frontmatter `description` (progressive
+     *  disclosure — this is what sits in the model's context until invoked). */
+    description: string;
+    /** MVP: all curated. 'user' is added with the library fast-follow. */
+    source: 'curated';
+    delivery: SkillDelivery;
+}
+/** What a deploy writes to `~/.codeam/skills.json` — ids only, never content. */
+interface SkillsManifestEntry {
+    id: SkillId;
+}
+interface SkillsManifest {
+    skills: SkillsManifestEntry[];
+}
+
+declare const SKILL_REGISTRY: Record<SkillId, SkillDefinition>;
+declare function isSkillId(id: string): id is SkillId;
+declare function getSkillDefinition(id: string): SkillDefinition | null;
+declare function skillHasRail(id: SkillId, rail: SkillRail): boolean;
+
 /**
  * Wire-shape types for the CLI / IDE-plugin → backend producer endpoints
  * that feed the mobile Files screen and the Pending Review Queue:
@@ -1435,4 +1484,4 @@ type UserEventName = (typeof USER_EVENTS)[keyof typeof USER_EVENTS];
  */
 declare const PREVIEW_DETECT_PROMPT: string;
 
-export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, toRemoteCommand, tryGetContextWindow };
+export { AGENT_REGISTRY, type AgentAuth, type AgentAuthKind, type AgentId, type AgentMetadata, type AgentMode, type AgentModel, type AgentReviewFinding, type AgentReviewPlan, type AgentReviewReport, type AnswerResolvedEvent, type AwaitingAnswerEvent, type BeadsActionCommand, type BeadsActionKind, type BeadsActionPayload, type BeadsActionRequest, type BeadsActionType, type BeadsConfigureAction, type BeadsDependencyDto, type BeadsDependencyKind, type BeadsIngestPayload, type BeadsIssueDto, type BeadsIssueStatus, type BeadsMemoryDto, type BeadsProjectDto, type BeadsProvisioningPayload, type BeadsProvisioningStatus, type BeadsSnapshotDto, type BeadsStatus, type BeadsStatusState, type BeadsStatusSummary, type BlameLineWire, type BrokeredIntegrationToken, type ChromeStep, type ChromeToolType, type CommitEntryWire, DEFAULT_API_BASE_URL, DEV_API_BASE_URL, type EnvVar, type FileBlameEvent, type FileChangeStatus, type FileChangedEvent, type FileHistoryEvent, type FileReviewStatus, HEADROOM_BACKEND_ENV, HEADROOM_EXTRAS_BY_SURFACE, HEADROOM_MODELS, HEADROOM_PIP_COMPANIONS, HEADROOM_PROXY_PORT, HEARTBEAT_INTERVAL_MS_DEFAULT, HOUSE_AGENT_ID, HOUSE_AGENT_NAME, HOUSE_AGENT_PROVIDER, HOUSE_AGENT_SUBTITLE, HOUSE_AGENT_VENDOR, type HeadroomBudgetCommand, type HeadroomBudgetPeriod, type HeadroomBudgetUsage, type HeadroomKind, type HeadroomModelSpec, type HeadroomPythonRenderOpts, type HeadroomStatus, type HeadroomStep, type HeadroomSurface, type HunkLineType, INTEGRATION_BRANDING, INTEGRATION_REGISTRY, INTERNAL_TO_PUBLIC, type InputSuggestionChunk, type IntegrationApiKeyField, type IntegrationAuthKind, type IntegrationBranding, type IntegrationCategory, type IntegrationDefinition, type IntegrationDelivery, type IntegrationHealth, type IntegrationId, type IntegrationMcpDelivery, type IntegrationStatus, type IntegrationsManifest, type IntegrationsManifestEntry, LINKED_AGENT_IDS, type LinkedAgentId, MODEL_CONTEXT_WINDOW, MODEL_PRICING, type ModelPricing, type NormalizedMessage, OBSERVER_BRIDGE_PORT, PREVIEW_DETECT_PROMPT, PROTOCOL_VERSION, PUBLIC_TO_INTERNAL, type PendingReviewHunkEvent, type PendingReviewHunkLine, type PrCheck, type PrRef, type PrReviewEntry, type PrReviewVerdict, type PreviewDetection, type PreviewErrorStage, type PreviewState, type PreviewStatus, type PullRequestDetail, type PullRequestSummary, type RemoteCommand, SKILL_REGISTRY, SSE_SOCKET_TIMEOUT_MS, type SelectPrompt, type SkillDefinition, type SkillDelivery, type SkillFileDelivery, type SkillId, type SkillRail, type SkillsManifest, type SkillsManifestEntry, type StreamingChunkEvent, type StreamingChunkKind, TERMINAL_AGENT_PREFIX, UNKNOWN_MODEL_PRICING, UPCOMING_INTEGRATION_IDS, USER_EVENTS, type UserEventName, getAgent, getContextWindow, getEnabledAgents, getEnabledIntegrations, getIntegration, getIntegrationBranding, getIntegrationsByCategory, getPricing, getSkillDefinition, headroomKindFor, headroomModelPredownloadScript, headroomPipPackage, headroomSnapshotDownloadLine, internalToPublic, isHeadroomWrappable, isKnownAgentId, isKnownIntegrationId, isKnownModel, isLinkedAgentId, isSkillId, normalizeAgentId, publicToInternal, renderToLines, resolveApiBaseUrl, skillHasRail, toRemoteCommand, tryGetContextWindow };

package/dist/index.js

@@ -44,6 +44,7 @@ __export(index_exports, {
   PREVIEW_DETECT_PROMPT: () => PREVIEW_DETECT_PROMPT,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
   PUBLIC_TO_INTERNAL: () => PUBLIC_TO_INTERNAL,
+  SKILL_REGISTRY: () => SKILL_REGISTRY,
   SSE_SOCKET_TIMEOUT_MS: () => SSE_SOCKET_TIMEOUT_MS,
   TERMINAL_AGENT_PREFIX: () => TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING: () => UNKNOWN_MODEL_PRICING,
@@ -57,6 +58,7 @@ __export(index_exports, {
   getIntegrationBranding: () => getIntegrationBranding,
   getIntegrationsByCategory: () => getIntegrationsByCategory,
   getPricing: () => getPricing,
+  getSkillDefinition: () => getSkillDefinition,
   headroomKindFor: () => headroomKindFor,
   headroomModelPredownloadScript: () => headroomModelPredownloadScript,
   headroomPipPackage: () => headroomPipPackage,
@@ -67,10 +69,12 @@ __export(index_exports, {
   isKnownIntegrationId: () => isKnownIntegrationId,
   isKnownModel: () => isKnownModel,
   isLinkedAgentId: () => isLinkedAgentId,
+  isSkillId: () => isSkillId,
   normalizeAgentId: () => normalizeAgentId,
   publicToInternal: () => publicToInternal,
   renderToLines: () => renderToLines,
   resolveApiBaseUrl: () => resolveApiBaseUrl,
+  skillHasRail: () => skillHasRail,
   toRemoteCommand: () => toRemoteCommand,
   tryGetContextWindow: () => tryGetContextWindow
 });
@@ -1100,6 +1104,94 @@ function getIntegrationBranding(id) {
   return INTEGRATION_BRANDING[id] ?? null;
 }
 
+// src/skills/registry.ts
+var CODE_REVIEW_BODY = `Use this skill when reviewing a pull request. It defines what a high-signal
+review looks like so your inline comments are worth the author's time.
+
+## Review priorities (in order)
+1. **Correctness** \u2014 does the change do what the PR says, and only that? Trace the
+   changed paths for logic errors, off-by-one, null/undefined, wrong branch, and
+   inverted conditions. State a concrete failure scenario (inputs \u2192 wrong output)
+   for anything you flag as a bug.
+2. **Security** \u2014 untrusted input reaching a sink (SQL, shell, path, HTML), secrets
+   in code/logs, authz gaps, credentials passed via argv instead of env.
+3. **Tests** \u2014 does the change carry tests that would fail without it? Missing
+   coverage on a bug-prone path is a finding.
+4. **Clarity / reuse** \u2014 duplicated logic, a simpler existing helper, a name that
+   misleads. Only raise these when they materially affect maintainability.
+
+## Comment discipline
+- One finding per comment, anchored to the exact line.
+- Lead with severity: **blocker**, **should-fix**, or **nit**.
+- Say WHY (the failure or risk), not just WHAT. Propose the fix when it is short.
+- Do NOT restate the diff, praise trivially, or nitpick style a formatter owns.
+- If the PR is correct and well-tested, say so plainly and approve \u2014 a clean review
+  is a valid outcome, not a failure to find something.
+
+## Scope
+Review only what the diff changes and its direct blast radius. Do not demand
+unrelated refactors.`;
+var CODE_REVIEW_INSTRUCTION = `When reviewing this PR, prioritize correctness first, then security, then test
+coverage, then clarity/reuse. One finding per inline comment, anchored to the exact
+line, each led by a severity tag (blocker/should-fix/nit) and a concrete reason
+(the failure scenario or risk), not a restatement of the diff. If the change is
+correct and well-tested, approve and say so \u2014 finding nothing is a valid outcome.
+Review only the diff and its direct blast radius; do not demand unrelated refactors.`;
+var RESOLVE_CONFLICTS_BODY = `Use this skill when resolving merge conflicts on a pull request. The goal is a
+merge that preserves BOTH sides' intent, not one that just makes the file compile.
+
+## Method
+1. Understand each conflict hunk before editing: what did HEAD change, what did the
+   base branch change, and WHY. Read the surrounding function, not just the markers.
+2. Prefer a union of intents. Drop a side only when the two changes are genuinely
+   mutually exclusive \u2014 and when you do, keep the side that matches the PR's purpose.
+3. Never leave a conflict marker (\`<<<<<<<\`, \`=======\`, \`>>>>>>>\`) behind. Grep for
+   them before committing.
+4. After resolving, the code must build and its tests must pass. Run them. A merge
+   that resolves markers but breaks the build is not done.
+5. For lockfiles/generated files, regenerate rather than hand-merge.
+
+## Commit
+One commit that explains what was reconciled and any intent you had to choose
+between. Then push the branch.`;
+var RESOLVE_CONFLICTS_INSTRUCTION = `When resolving these merge conflicts, preserve both sides' intent \u2014 read each hunk's
+surrounding code to understand what HEAD and the base branch each changed and why,
+and prefer a union of intents; drop a side only when the two are mutually exclusive,
+keeping the side that matches the PR's purpose. Leave no conflict markers behind
+(grep for them). Regenerate lockfiles rather than hand-merging them. The result must
+build and pass tests \u2014 run them \u2014 before you commit and push.`;
+var SKILL_REGISTRY = {
+  "code-review": {
+    id: "code-review",
+    name: "Code Review",
+    description: `High-signal PR review: prioritize correctness \u2192 security \u2192 tests \u2192 clarity, one anchored finding per comment.`,
+    source: "curated",
+    delivery: {
+      skillFile: { body: CODE_REVIEW_BODY },
+      instruction: { body: CODE_REVIEW_INSTRUCTION }
+    }
+  },
+  "resolve-conflicts": {
+    id: "resolve-conflicts",
+    name: "Resolve Conflicts",
+    description: `Merge-conflict resolution that preserves both sides' intent, leaves no markers, and keeps the build green.`,
+    source: "curated",
+    delivery: {
+      skillFile: { body: RESOLVE_CONFLICTS_BODY },
+      instruction: { body: RESOLVE_CONFLICTS_INSTRUCTION }
+    }
+  }
+};
+function isSkillId(id) {
+  return Object.prototype.hasOwnProperty.call(SKILL_REGISTRY, id);
+}
+function getSkillDefinition(id) {
+  return isSkillId(id) ? SKILL_REGISTRY[id] : null;
+}
+function skillHasRail(id, rail) {
+  return Boolean(SKILL_REGISTRY[id].delivery[rail]);
+}
+
 // src/api-url.ts
 var DEFAULT_API_BASE_URL = "https://api.codeagent-mobile.com";
 var DEV_API_BASE_URL = "https://dev-api.codeagent-mobile.com";
@@ -1312,6 +1404,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   PREVIEW_DETECT_PROMPT,
   PROTOCOL_VERSION,
   PUBLIC_TO_INTERNAL,
+  SKILL_REGISTRY,
   SSE_SOCKET_TIMEOUT_MS,
   TERMINAL_AGENT_PREFIX,
   UNKNOWN_MODEL_PRICING,
@@ -1325,6 +1418,7 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   getIntegrationBranding,
   getIntegrationsByCategory,
   getPricing,
+  getSkillDefinition,
   headroomKindFor,
   headroomModelPredownloadScript,
   headroomPipPackage,
@@ -1335,10 +1429,12 @@ OUTPUT JSON ONLY. NO MARKDOWN. NO COMMENTARY.
   isKnownIntegrationId,
   isKnownModel,
   isLinkedAgentId,
+  isSkillId,
   normalizeAgentId,
   publicToInternal,
   renderToLines,
   resolveApiBaseUrl,
+  skillHasRail,
   toRemoteCommand,
   tryGetContextWindow
 });