Cursor plugin specification and official plugins
TypeScript
Add origin-api skill; porting skill builds on it
Cursor Agente0efb7a93e59
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 0af83a86..505ac1ad 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -8,7 +8,7 @@{"name": "origin-apps","source": "./origin-apps",- "description": "Plan the port of an existing GitHub App to a Cursor Origin App: discover its GitHub surface, map it onto the live Origin API, write a porting brief."+ "description": "Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App."}]}diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 556d6a14..484fedf2 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -66,7 +66,7 @@{"name": "origin-apps","source": "origin-apps",- "description": "Plan the port of an existing GitHub App to a Cursor Origin App: discover its GitHub surface, map it onto the live Origin API, write a porting brief."+ "description": "Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App."},{"name": "orchestrate",diff --git a/README.md b/README.mdindex f29ea65c..a6418fb7 100644--- a/README.md+++ b/README.md@@ -17,7 +17,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `pr-review-canvas` | [PR Review Canvas](pr-review-canvas/) | Cursor | Developer Tools | Render PR diffs as review canvases grouped by importance. || `docs-canvas` | [Docs Canvas](docs-canvas/) | Cursor | Developer Tools | Render documentation as a navigable canvas. || `cursor-sdk` | [Cursor SDK](cursor-sdk/) | Cursor | Developer Tools | Build apps, scripts, and automations with the TypeScript SDK. |-| `origin-apps` | [Origin Apps](origin-apps/) | Cursor | Developer Tools | Plan the port of an existing GitHub App to a Cursor Origin App: discover its GitHub surface, map it onto the live Origin API, write a porting brief. |+| `origin-apps` | [Origin Apps](origin-apps/) | Cursor | Developer Tools | Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App. || `orchestrate` | [Orchestrate](orchestrate/) | Cursor | Developer Tools | Fan large tasks out across parallel cloud agents with planners, workers, verifiers, and structured handoffs. || `pstack` | [pstack](pstack/) | Lauren Tan | Developer Tools | if you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. || `advisor` | [Advisor](advisor/) | Cursor | Developer Tools | Consult a stronger model before major decisions, when stuck, and before declaring done. |diff --git a/origin-apps/.claude-plugin/plugin.json b/origin-apps/.claude-plugin/plugin.jsonindex 9d1cb54b..b09982da 100644--- a/origin-apps/.claude-plugin/plugin.json+++ b/origin-apps/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "origin-apps",- "description": "Plan the port of an existing GitHub App to a Cursor Origin App: discover the app's GitHub surface, map it onto the live Origin API, write a porting brief.",+ "description": "Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App.","version": "0.1.0","author": {"name": "Cursor",@@ -12,8 +12,9 @@"keywords": ["origin","origin-api",- "github-app",+ "origin-app","webhooks",+ "github-app","integration","porting"],diff --git a/origin-apps/.cursor-plugin/plugin.json b/origin-apps/.cursor-plugin/plugin.jsonindex 0d130e52..edd88eed 100644--- a/origin-apps/.cursor-plugin/plugin.json+++ b/origin-apps/.cursor-plugin/plugin.json@@ -2,7 +2,7 @@"name": "origin-apps","displayName": "Origin Apps","version": "0.1.0",- "description": "Plan the port of an existing GitHub App to a Cursor Origin App: discover the app's GitHub surface, map it onto the live Origin API, write a porting brief.",+ "description": "Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App.","author": {"name": "Cursor","email": "[email protected]"@@ -14,17 +14,19 @@"cursor-plugin","origin","origin-api",- "github-app",+ "origin-app","webhooks",+ "github-app","integration","porting"],"category": "developer-tools","tags": ["origin",+ "origin-api",+ "webhooks","github-app",- "integration",- "planning"+ "integration"],"skills": "./skills/"}diff --git a/origin-apps/CHANGELOG.md b/origin-apps/CHANGELOG.mdindex d5d9a2ec..f7285b41 100644--- a/origin-apps/CHANGELOG.md+++ b/origin-apps/CHANGELOG.md@@ -4,7 +4,12 @@ All notable changes to this plugin will be documented here.## 0.1.0 — initial release-- Added the `port-github-app-to-origin` skill: discover a GitHub App's surface- from its codebase, map it onto the live Origin API spec, and write a porting- brief with a capability table, webhook field map, hello-world path, gap cards,- and up-front questions.+- Added the `origin-api` skill: fetch the live Origin docs and OpenAPI spec+ first, then apply the practices that hold across spec versions (credentials+ and token minting, minimal scopes, webhook verification and idempotency,+ opaque page tokens, TypeIDs, the error envelope, rate limits, and the+ deliberate differences from GitHub).+- Added the `port-github-app-to-origin` skill, built on `origin-api`: discover+ a GitHub App's surface from its codebase, map it onto the live Origin API+ spec, and write a porting brief with a capability table, webhook field map,+ hello-world path, gap cards, and up-front questions.diff --git a/origin-apps/README.md b/origin-apps/README.mdindex 8324e10b..6e0ba067 100644--- a/origin-apps/README.md+++ b/origin-apps/README.md@@ -1,36 +1,49 @@# Origin Apps-Plugin for teams bringing an existing GitHub App to-[Cursor Origin](https://cursor.com/docs/api/origin), Cursor's code forge.-Skills only, so it runs in Cursor, Claude Code, Codex, and any agent that-reads [Agent Skills](https://agentskills.io).+Plugin for building on [Cursor Origin](https://cursor.com/docs/api/origin),+Cursor's code forge: creating an Origin App, calling the API, receiving+webhooks, or bringing an existing GitHub App across. Skills only, so it runs+in Cursor, Claude Code, Codex, and any agent that reads+[Agent Skills](https://agentskills.io).## What it includes-- `port-github-app-to-origin`: run it inside your GitHub App's repository with- no other instructions. It discovers the app's GitHub surface from the code- (manifest, permissions, events handled, payload fields read, REST and GraphQL- calls, token minting, webhook receiver, calls your framework makes for you),- fetches the live Origin API spec, and writes a porting brief: a capability- table, the webhook fields your handlers read and where each comes from on- Origin, the scopes to request, a hello-world path to your first real event,- gaps worth raising with Cursor, and the questions your team should settle- first.--The skill plans; it does not write port code, pick a language or SDK, or-estimate in time. Mappings come from the Origin OpenAPI spec at run time, so the-brief tracks the API as published on the day you run it.+- `origin-api`: the general skill. Points the agent at the live docs and+ OpenAPI spec first (the only source for endpoints, scopes, and event slugs),+ then carries the practices that hold across spec versions: app, installation,+ and user credentials and just-in-time token minting; minimal scopes derived+ from `x-origin-scopes`; webhook subscription, `v1ed` signature verification,+ idempotent handling, and delivery behavior; opaque page tokens; TypeIDs; the+ error envelope; rate limits; and the deliberate differences from GitHub (no+ commit statuses, Issues, or GraphQL). Use it for any Origin work.+- `port-github-app-to-origin`: builds on `origin-api` for one job. Run it+ inside your GitHub App's repository with no other instructions. It discovers+ the app's GitHub surface from the code (manifest, permissions, events+ handled, payload fields read, REST and GraphQL calls, token minting, webhook+ receiver, calls your framework makes for you), maps it onto the live spec,+ and writes a porting brief: a capability table, the webhook fields your+ handlers read and where each comes from on Origin, the scopes to request, a+ hello-world path to your first real event, gaps worth raising with Cursor,+ and the questions your team should settle first. It plans; it does not write+ port code, pick a language or SDK, or estimate in time.++Both skills fetch the spec at run time and refuse to name an endpoint from+memory, so their output tracks the API as published on the day you run them.## When to use+- You are writing or reviewing code that calls Origin, mints installation+ tokens, or receives Origin webhooks: `origin-api`.+- You are creating an Origin App and want the hello-world path and the+ first-week traps up front: `origin-api`.- You have a GitHub App (Probot, Octokit, go-github, hand-rolled) and want to- know what an Origin App version looks like before you start.-- You are an agent working on such a team's behalf and need a grounded plan.+ know what an Origin App version looks like before you start:+ `port-github-app-to-origin`.- You want to check which GitHub features Origin deliberately does not- reproduce, and what the Origin idiom is instead.+ reproduce, and what the Origin idiom is instead: either.-In Cursor, open the app's repository and ask to port it to Origin, or run-`/port-github-app-to-origin`.+In Cursor, ask about the Origin API or ask to port the app; or run+`/origin-api` or `/port-github-app-to-origin`.## Install in Cursor@@ -44,7 +57,7 @@ scope.The plugin ships three manifests for one set of skills: a root `plugin.json`([Agent Plugins](https://agent-plugins.org) 1.0), `.cursor-plugin/plugin.json`(Cursor Marketplace), and `.claude-plugin/plugin.json` (Claude Code). The-skill uses only portable frontmatter (`name`, `description`, `license`,+skills use only portable frontmatter (`name`, `description`, `license`,`compatibility`).**Claude Code**, via the marketplace manifest at this repository's root:@@ -55,32 +68,34 @@ skill uses only portable frontmatter (`name`, `description`, `license`,```**Any agent that reads Agent Skills** (Claude Code, Codex, and others): copy-the skill directory into the agent's skills folder.+the skill directories into the agent's skills folder. Copy both; the porting+skill refers to `origin-api` for fundamentals.```bashgit clone --depth 1 https://github.com/cursor/plugins.git# Claude Code-mkdir -p .claude/skills && cp -r plugins/origin-apps/skills/port-github-app-to-origin .claude/skills/+mkdir -p .claude/skills && cp -r plugins/origin-apps/skills/* .claude/skills/# Codex-mkdir -p .codex/skills && cp -r plugins/origin-apps/skills/port-github-app-to-origin .codex/skills/+mkdir -p .codex/skills && cp -r plugins/origin-apps/skills/* .codex/skills/# Cursor, without the marketplace-mkdir -p .cursor/skills && cp -r plugins/origin-apps/skills/port-github-app-to-origin .cursor/skills/+mkdir -p .cursor/skills && cp -r plugins/origin-apps/skills/* .cursor/skills/```## Requirements- Network access to `https://cursor.com/docs/api/origin/*` during the run.-- Read access to the app's source. No Origin credentials are needed to produce- the brief; the hello-world path in the brief is what you follow afterwards.-- Optional: `python3` with PyYAML for `scripts/index-origin-spec.py`, which- turns the fetched spec into a grep-friendly index. Without it the skill- reads the spec directly.+- For the porting skill: read access to the app's source. No Origin+ credentials are needed to produce the brief; the hello-world path in the+ brief is what you follow afterwards.+- Optional: `python3` with PyYAML for the porting skill's+ `scripts/index-origin-spec.py`, which turns the fetched spec into a+ grep-friendly index. Without it the skill reads the spec directly.## Where the brief goes-The skill writes `ORIGIN-PORTING-BRIEF.md` at the repository root and prints-its path. Gap cards in the brief are yours to send: through your shared Slack-channel with Cursor if you have one, or to `[email protected]`.+The porting skill writes `ORIGIN-PORTING-BRIEF.md` at the repository root and+prints its path. Gap cards in the brief are yours to send: through your shared+Slack channel with Cursor if you have one, or to `[email protected]`.## Licensediff --git a/origin-apps/plugin.json b/origin-apps/plugin.jsonindex a0d396b5..61a2f288 100644--- a/origin-apps/plugin.json+++ b/origin-apps/plugin.json@@ -2,7 +2,7 @@"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json","name": "origin-apps","version": "0.1.0",- "description": "Plan the port of an existing GitHub App to a Cursor Origin App: discover the app's GitHub surface, map it onto the live Origin API, write a porting brief.",+ "description": "Build on the Cursor Origin API: fetch the live spec first, then apply durable practices for credentials, scopes, webhooks, paging, and errors; includes a skill that plans the port of an existing GitHub App.","author": {"name": "Cursor","email": "[email protected]"@@ -13,8 +13,9 @@"keywords": ["origin","origin-api",- "github-app",+ "origin-app","webhooks",+ "github-app","integration","porting"]diff --git a/origin-apps/skills/origin-api/SKILL.md b/origin-apps/skills/origin-api/SKILL.mdnew file mode 100644index 00000000..21165aa4--- /dev/null+++ b/origin-apps/skills/origin-api/SKILL.md@@ -0,0 +1,173 @@+---+name: origin-api+description: >-+ Build on the Cursor Origin API: create an Origin App, authenticate as it,+ call the REST API, receive webhooks. Use whenever code or a plan touches+ Origin endpoints, installation tokens, scopes, webhook subscriptions or+ signatures, page tokens, or an Origin App manifest. Points at the live docs+ and spec first and carries only the practices that do not change between+ spec versions.+license: MIT+compatibility: >-+ Needs network access to https://cursor.com/docs/api/origin/* at run time.+---++# Build on the Origin API++Origin is Cursor's code forge. Its API is GitHub-shaped (repos, pull requests,+reviews, comments, check runs, labels, branches, commits) and deliberately not+GitHub-compatible on the wire. This skill tells you where the contract lives+and what stays true across versions of it. It does not restate endpoints,+schemas, scope strings, or event slugs; those come from the spec you fetch.++## Fetch the spec; do not trust memory++Before naming any endpoint, scope, event slug, header, or field, fetch:++- `https://cursor.com/docs/api/origin/llms.txt` — index of the docs+- `https://cursor.com/docs/api/origin/openapi.yaml` — the contract (OpenAPI+ 3.1). Every operation carries `x-origin-scopes` (`scopes`, `tokenTypes`,+ `ambient`); every webhook payload schema carries `x-origin-webhook-events`+ (the slugs that deliver it) and often `x-origin-webhook-resource`;+ `x-cursor-visibility: PREVIEW` marks operations whose shape may still move.+- `https://cursor.com/docs/api/origin/llms-full.txt` — the prose the spec+ cannot carry: installation flow, authentication, scopes table, mirrored+ repositories, webhook headers and signature verification, delivery+ envelope, retries, pagination, errors, current limitations+- `https://cursor.com/docs/api/origin/changelog` — what moved recently++Cite `operationId`s and `llms-full.txt` anchors in anything you write. Record+`info.version` and the fetch time when the output will outlive the session.+Where this file and the fetched docs disagree, the docs win.++## Practices that hold across spec versions++### Credentials++- Three principals, in order of power: **user** credential (admin actions:+ create the app, add repositories to an installation, mirror transitions),+ **app** JWT (EdDSA over Ed25519; register only the public key; identifies+ the app to app-level operations), **installation** token (`oit_…`,+ short-lived, minted from the app JWT for one installation; the credential+ for repository work). Check an operation's `x-origin-scopes.tokenTypes` to+ see which it accepts.+- Mint installation tokens just in time and let them expire; never persist+ one as a long-lived secret. Attenuate at mint time to the scopes and+ `repositoryIds` the job needs (IDs, not slugs).+- The installation **receipt** JWT returned from the install redirect proves+ consent and carries the installation ID. It is never a Bearer token.+- Git over HTTPS uses Basic auth with username `x-access-token` and an+ installation token as the password; Bearer is for REST only.++### Scopes++- Scopes are `repository:<noun>[:<sub>]:<read|write>`; `write` implies `read`;+ `repository:metadata:read` comes with every installation.+- Request the union of `x-origin-scopes.scopes` across the operations you+ actually call, nothing more. An installation can only narrow what the admin+ approved, so an over-broad manifest is a review burden, not a convenience.+- `ambient: true` means the credential already carries the scope; there is+ nothing to request for it.++### Repositories++- Apps act on Origin-native repositories. A repository mirrored *from* GitHub+ is read-only to an installation (writes return `403`) and does not deliver+ `repository.pushed`, because GitHub already notifies apps for it. Confirm+ native-or-mirror before anything else; a mirror produces a successful ping+ and then silence.++### Webhooks++- Only installation lifecycle events are delivered by default. Every other+ event must be selected in app settings. Take the slug list from+ `x-origin-webhook-events`, not from GitHub habit.+- Verify before parsing. Scheme `v1ed`: Ed25519 over a SHA-256 digest of the+ raw body, keys from Origin's JWKS (cache per `Cache-Control`; keys rotate).+ Reject `webhook-timestamp` more than five minutes off. It follows Standard+ Webhooks except for signing a digest, so off-the-shelf verifiers do not+ validate it unmodified. Routing headers are `webhook-*`, not `x-github-*`;+ after verification the body is authoritative.+- Handle idempotently. `deliveryId` in the envelope is stable across retries+ and is the dedupe key; `event.id` identifies the domain event. Delivery is+ at-least-once.+- Acknowledge fast, process later. Retries follow a schedule and persistent+ failure pauses delivery for the app; the recovery window is finite and+ redelivery is through the deliveries operations, so a slow handler costs+ you events. Return `2xx` after verification and enqueue.+- Payloads are lean snapshots of the one object that changed, plus compact+ references to its containers. No changed-file lists, before-SHAs, web URLs,+ or inlined profiles. The intended pattern is a follow-up `Get…` with the+ identifiers the payload carries; count that fan-out when you design.+- The action lives in the slug (`pull_request.created`,+ `pull_request.review.submitted`); there is no `action` field and no+ `previous_attributes` delta.++### Pagination++- `pageSize` / `pageToken` / `nextPageToken`. Tokens are opaque and bound to+ the resource and filters: never construct, parse, persist across filter+ changes, or share them between requests with different parameters.+- Pass `pageSize` on every request, including continuations; do not rely on+ the token to remember it. No `Link` header, no page numbers, no total count.+ Loop until `nextPageToken` is absent or empty.++### Identifiers and wire shape++- IDs are opaque prefixed TypeIDs (`app_…`, `i_…`, `repo_…`, `user_…`,+ `cmt_…`). Never integers, never derived. Cache IDs, not slugs; a repository+ is addressable as `/repos/_/{repoId}`, which survives renames.+- camelCase JSON; 64-bit integers (PR numbers, versions) are JSON strings;+ RFC 3339 timestamps; defaults are present (`false`, `0`, `""`, `[]`), so a+ present `false` is a value and a missing key is only the default when the+ field is documented optional.+- Public terminology is "pull request"; do not look for "change" on the wire.++### Errors++- One envelope: `google.rpc.Status` `{code, message, details}` with typed+ `details` (`BadRequest` field violations, `RequestInfo` with the request+ id; more types may appear, so tolerate unknown ones). `X-Request-ID` is on+ every error; quote it when escalating.+- `404` does not distinguish not-found from no-access. Branch on HTTP status+ and `code`, never on message text.++### Rate limits++- A per-principal point budget: read `X-RateLimit-*` on every response and+ honor `Retry-After` on `429`. Git over HTTPS is metered separately+ (`X-RateLimit-Resource: git`). Cursor raises per-app budgets on request;+ ask rather than spinning.++### Deliberate differences from GitHub++Design decisions, not gaps. Build the Origin idiom instead of emulating the+GitHub one:++- **No commit statuses.** Check runs are the one status primitive; they upsert+ on a caller-stable `key` and rulesets bind on that key.+- **No Issues.** Conversation is pull request comments, threads, reviews, and+ labels on pull requests.+- **No GraphQL.** REST only; decompose queries and accept the fan-out.+- **No per-repository webhook CRUD.** Subscriptions are app settings.+- **No user or email directory**, no team pages; actors are TypeIDs (plus a+ handle where the contract exposes it).+- **Reviews anchor to a pull request version**, not a commit SHA.+- **No standalone threads API.** A thread materializes from its first+ diff-anchored comment.++## Hello-world path++Create the app (form or user-credential `CreateApp`) → register the Ed25519+public key → select webhook events → install on an Origin-native repository →+verify the ping signature → mint an installation token → first `Get…` → first+real event. Each arrow is a step to observe, not code to write; when a step+is silent, the answer is almost always native-or-mirror or an unsubscribed+event.++## Related skill++`port-github-app-to-origin`, in this plugin, applies these fundamentals to+an existing GitHub App: it discovers the app's GitHub surface from code, maps+it onto the spec, and writes a porting brief. Use it for a port; use this+skill for everything else on Origin.diff --git a/origin-apps/skills/port-github-app-to-origin/SKILL.md b/origin-apps/skills/port-github-app-to-origin/SKILL.mdindex 566f3725..08083651 100644--- a/origin-apps/skills/port-github-app-to-origin/SKILL.md+++ b/origin-apps/skills/port-github-app-to-origin/SKILL.md@@ -23,40 +23,31 @@ you. The team keeps its language, framework, and client strategy; the brieftells them what maps, what changes shape, what is absent on purpose, and whatis worth raising with Cursor.-Three rules shape everything below:--1. **The live Origin docs are the source of truth.** Fetch them at run time- and derive every mapping from them. Nothing in this skill pins a version or- enumerates endpoints; the `references/` files explain *how to read* the spec- and *why* Origin differs, and any concrete example in them is illustrative- until you have confirmed it against today's spec.-2. **Discover, do not ask.** Read the manifest, permission declarations, event+Fundamentals come from the `origin-api` skill in this plugin: which docs to+fetch, credentials and token minting, scopes, webhook verification and+idempotency, pagination, TypeIDs, errors, rate limits, and the list of+deliberate departures from GitHub. Follow it first; this skill adds only what+a port needs on top. Two rules shape the porting work:++1. **Discover, do not ask.** Read the manifest, permission declarations, eventhandlers, token minting, API calls, and webhook receiver out of the code.Never ask anyone to paste a manifest or list their endpoints. If somethingis genuinely undiscoverable, record it as an open question in the brief.-3. **Origin is GitHub-shaped, not GitHub-compatible.** Many differences are- decisions, not omissions. Classify them as such and guide the port toward- the Origin idiom instead of reproducing the GitHub one.+2. **Classify departures as decisions, not omissions.** A GitHub feature that+ Origin deliberately does not reproduce is `by-design-absent` with a pointer+ to the Origin idiom, never a gap card. Nothing in this skill pins a spec+ version or enumerates endpoints; every concrete example in `references/`+ is illustrative until confirmed against today's spec.## Procedure### 1. Load the live Origin surface-Fetch, in this order, and keep them open for the rest of the run:--- `https://cursor.com/docs/api/origin/llms.txt` (index of everything below)-- `https://cursor.com/docs/api/origin/openapi.yaml` (the contract; every- mapping in the brief cites an `operationId` or a payload schema from it)-- `https://cursor.com/docs/api/origin/llms-full.txt` (the human reference:- installation, authentication, scopes, mirrored repositories, webhooks,- conventions, current limitations)-- `https://cursor.com/docs/api/origin/changelog` (what moved recently)--Record `info.version` and the fetch time in the brief's provenance block. That-is provenance, not a dependency: the brief describes the API as it is today and-says so. `references/spec-mapping.md` explains the spec's `x-origin-scopes`,-`x-origin-webhook-events`, `x-origin-webhook-resource`, and-`x-cursor-visibility` extensions and how to build the mapping index from them.+Fetch the four URLs from `origin-api` § Fetch the spec and keep them open for+the run. Record `info.version` and the fetch time in the brief's provenance+block; that is provenance, not a dependency, and the brief says so.+`references/spec-mapping.md` explains how to turn the spec's `x-origin-*`+extensions into the mapping index every later step looks things up in.`scripts/index-origin-spec.py <openapi.yaml>` prints that index (operationswith scopes, parameters, and response fields; webhook slugs with payloadfields; the scope catalog) so you can grep it instead of paging through 700 KB@@ -126,9 +117,10 @@ real events at all.| File | Read when || --- | --- |+| `../origin-api/SKILL.md` | Always, first: the docs to fetch and the fundamentals every mapping row assumes. || `references/spec-mapping.md` | Building the spec index and matching GitHub calls, events, and payload fields to Origin operations, slugs, and schemas. || `references/discovery.md` | Scanning the codebase for the app's GitHub surface. |-| `references/origin-isms.md` | Deciding whether a missing GitHub feature is a decision or a gap, and what the Origin idiom is. |+| `references/origin-isms.md` | Deciding whether a missing GitHub feature is a decision or a gap, and what the Origin idiom is, with the reasoning a team that only knows GitHub needs. || `references/gap-bar.md` | Deciding whether a gap is worth raising with Cursor, and writing the card. || `references/brief-template.md` | Writing the output. || `scripts/index-origin-spec.py` | Turning the fetched `openapi.yaml` into a grep-friendly index (operations, webhook families, scopes, one component). Optional; needs PyYAML. |diff --git a/origin-apps/skills/port-github-app-to-origin/references/origin-isms.md b/origin-apps/skills/port-github-app-to-origin/references/origin-isms.mdindex d81f7226..112c988c 100644--- a/origin-apps/skills/port-github-app-to-origin/references/origin-isms.md+++ b/origin-apps/skills/port-github-app-to-origin/references/origin-isms.md@@ -7,7 +7,8 @@ the brief, and the brief's job is to point the team at the Origin idiom. Eachentry gives the departure, the idiom, and the reason in one line, so you canexplain it to a team that has only ever seen GitHub. Confirm the currentwording in `llms-full.txt`; this file explains intent, the docs state the-contract.+contract. The `origin-api` skill carries the same conventions as practices+for building; this file carries them as parity decisions for a port.## Which repositories an app can act on