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.mdindex 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.mdindex 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") andlabel 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` beforewriting 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.mdindex 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) |