Skip to content

Cursor plugin specification and official plugins

TypeScript

Keep GitHub differences in the porting skill only

Cursor Agent06ad1fa25685
diff --git a/origin-apps/skills/origin-api/SKILL.md b/origin-apps/skills/origin-api/SKILL.md
index 837c5c86..258b7f1a 100644
--- a/origin-apps/skills/origin-api/SKILL.md
+++ b/origin-apps/skills/origin-api/SKILL.md
@@ -43,7 +43,6 @@ docs disagree, the docs win.
| Pagination, errors, request IDs, repository paths | `#common-conventions` |
| ID form and stability | `#ids` |
| What a `PREVIEW` badge means | `#preview` |
-| GitHub features Origin does not have | `#coming-from-github` |
| Rate limits and headers | `#rate-limits` |
| Check-run keys, attempts, stale writes | `#check-runs` |
| What is not there yet | `#current-limitations` |
@@ -73,6 +72,5 @@ week.
## Coming from GitHub
-GitHub habits do not carry over. Before mapping a GitHub feature onto Origin,
-read `#coming-from-github` for what Origin does not have and what to use
-instead.
+GitHub habits do not carry over. The `port-github-app-to-origin` skill in
+this plugin covers the differences.
diff --git a/origin-apps/skills/port-github-app-to-origin/SKILL.md b/origin-apps/skills/port-github-app-to-origin/SKILL.md
index 5ec551f8..195a09b2 100644
--- a/origin-apps/skills/port-github-app-to-origin/SKILL.md
+++ b/origin-apps/skills/port-github-app-to-origin/SKILL.md
@@ -44,9 +44,9 @@ GitHub. Follow it first. Nothing here repeats it. Two rules on top:
find.
3. **Map** each inventory row (`references/spec-mapping.md`, "Matching") and
label it with the parity labels in the brief template. Map the webhook
- payload fields the code reads, not only the event names. A field GitHub
- inlines is often a follow-up read on Origin, so name the call for each
- field. Then:
+ payload fields the code reads, not only the event names. If a payload
+ lacks a field the REST resource has, read the resource; see the per-field
+ notes under `#event-payloads`. Name the call for each such field. Then:
- Check `origin-isms.md` before writing `gap`. Check `gap-bar.md` before
writing any card.
- A GitHub feature the Origin docs never mention (Marketplace billing,
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.md
index 1be7fe4d..8a3d7e26 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
@@ -11,24 +11,24 @@ Read the source; do not copy this table into the brief.
| Install callback query parameters (`installation_id`, `setup_action`) | `reshaped` | `#installation-receipt` |
| RS256 app JWT | `reshaped` | `#app-jwt` |
| Long-lived installation tokens | `reshaped` | `#installation-access-token` |
-| User OAuth, `/user`, `/user/installations`, install-by-user picker | `by-design-absent` | `#coming-from-github`; `#scopes` (user-credential operations). Ask what the flow should do. |
+| User OAuth, `/user`, `/user/installations`, install-by-user picker | `by-design-absent` | `#scopes` (user-credential operations); repository discovery through the installation. Ask what the flow should do. |
| Permissions `<noun>: read\|write` | `reshaped` | `#scopes`; `x-origin-scopes` per operation |
| Numeric IDs, `/repositories/{id}` | `reshaped` | `#ids`, `#repository-paths` |
| `Link` / `page` / `per_page` pagination, total counts | `reshaped` | `#pagination` |
-| GraphQL | `by-design-absent` | `#coming-from-github`. Decompose and count the fan-out. |
-| Commit statuses (`statuses` permission, `POST /statuses/{sha}`) | `reshaped` | `#coming-from-github`, `#check-runs` |
-| Issues (`issues` permission, `issues.*` events, `/issues/{n}` not on a pull request) | `by-design-absent` | `#coming-from-github`. Ask what the pull-request-scoped behavior should be. |
+| GraphQL | `by-design-absent` | No GraphQL endpoint in the spec. Decompose into REST calls and count the fan-out. |
+| Commit statuses (`statuses` permission, `POST /statuses/{sha}`) | `reshaped` | `#check-runs` (check runs with a stable `key`) |
+| Issues (`issues` permission, `issues.*` events, `/issues/{n}` not on a pull request) | `by-design-absent` | No Issues in the spec; conversation is pull request comments, threads, reviews, labels. Ask what the pull-request-scoped behavior should be. |
| `/issues/{n}/comments`, `/issues/{n}/labels` used on a pull request | `reshaped` | Pull requests endpoint reference; same calls under `/pulls/{n}/…` |
-| Repository webhook CRUD (`/repos/…/hooks`) | `by-design-absent` | `#coming-from-github`, `#events` |
+| Repository webhook CRUD (`/repos/…/hooks`) | `by-design-absent` | Subscriptions are app settings (`#events`) |
| App-manifest conversion, OAuth-app token mints | `by-design-absent` | `#installation`, Create App in the endpoint reference |
| Git Data API tree/blob writes | `by-design-absent` | `#git-https-authentication`; Git data endpoint reference |
| Standalone review-thread objects | `reshaped` | `#current-limitations`; Pull requests endpoint reference |
-| User, email, team, and member lookups | `by-design-absent` | `#coming-from-github`, `#resource-references` |
+| User, email, team, and member lookups | `by-design-absent` | `#resource-references`; no directory operations in the spec |
| Single `pull_request` event with an `action` field, `previous_attributes` | `reshaped` | `#events`, `#event-payloads` |
| `x-github-*` headers, HMAC `x-hub-signature-256` | `reshaped` | `#headers`, `#signature-verification` |
| Payload inlines (changed files on push, before-SHA, `html_url`, `sender` profile) | `reshaped` | `#current-limitations`, `#resource-references`. Name the follow-up call per field and count the fan-out. |
| All events delivered after app creation | `reshaped` | `#events` |
-| Reviews keyed by `commit_id` | `reshaped` | `#coming-from-github` |
+| Reviews keyed by `commit_id` | `reshaped` | `pullRequestVersion` on the review schema |
| Finding own check runs or comments by actor | `reshaped` | `#check-runs` (`key`); comments and reviews by a marker the app controls |
| Requested-reviewer team pages, `created_via` | `by-design-absent` | Pull requests endpoint reference (reviewers by identifier) |