[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7802XC2FE6ZM4HRMV7AMAMW":3,"skill-same:01M7802XC2FE6ZM4HRMV7AMAMW":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7802XC2FE6ZM4HRMV7AMAMW","github-api",null,"Use when calling GitHub's REST or GraphQL API from Effect v4 code through @effected\u002Fgithub — typing a client.request call by route, choosing paginate vs paginateStream, building a GitBranch or GitTag upsert, classifying or catching a GitHubError, or wiring a resource service's layer.","spencerbeggs\u002Feffected","spencerbeggs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F109114?v=4","01M77ZTHB70K5Y2VVTRCFY50A5","C. Spencer Beggs","01M77ZTHCC41NXBT3X906K6QM1",8,"MIT","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Fgithub-api\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: github-api\ndescription: Use when calling GitHub's REST or GraphQL API from Effect v4 code through @effected\u002Fgithub — typing a client.request call by route, choosing paginate vs paginateStream, building a GitBranch or GitTag upsert, classifying or catching a GitHubError, or wiring a resource service's layer.\nwhen_to_use: client.request, requestDecoded, GitHubError, Repo, RetryPolicy, GraphQLDocument, TokenPermissions, CheckRunOutput, CommentMarker, GitBranch upsert, GitTag upsert, GitHub REST API, GitHub GraphQL API\n---\n\n# `@effected\u002Fgithub`: calling GitHub from Effect v4\n\nTyped GitHub REST and GraphQL over `@octokit\u002Fcore`'s request surface, plus\nthe resource services (`GitBranch`, `PullRequest`, `GitHubIssue`, …) that\nturn raw endpoints into domain operations. General Effect v4 rules — service\nshapes, layer composition, memoization, `Schema.Class`, testing idioms —\nlive in `effect-v4-services-layers`, `effect-v4-schema`, `effect-v4-idioms`,\n`effect-v4-testing`; this skill states only what `@effected\u002Fgithub` does\ndifferently or as a worked instance.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `GitHubClient` (`.request`, `.requestDecoded`, `.paginate`, `.paginateStream`, `.graphql`, `.rateLimit`) | `import { GitHubClient } from \"@effected\u002Fgithub\"` | Calling any REST or GraphQL endpoint directly |\n| `Repo` | `@effected\u002Fgithub` | Scoping a program to an `owner`\u002F`repo` pair, or targeting a second repo mid-program |\n| `RetryPolicy` | `@effected\u002Fgithub` | Configuring the client's one retry\u002Fbackoff policy |\n| `GitHubError`, `GitHubGraphQLError` | `@effected\u002Fgithub` | Classifying or catching a REST\u002FGraphQL failure |\n| `GraphQLDocument` | `@effected\u002Fgithub` | Building a typed GraphQL query or mutation |\n| `GitBranch`, `GitTag`, `GitCommit` | `@effected\u002Fgithub` | Writing branches, tags, commits and trees through the Git Database API |\n| `GitHubCommit` | `@effected\u002Fgithub` | Reading commits as GitHub reports them (not the Git Database API) |\n| `GitHubRepository`, `GitHubContent` | `@effected\u002Fgithub` | Repo settings\u002Fdefault branch, or reading a file at a ref |\n| `GitHubIssue`, `PullRequest`, `PullRequestComment` | `@effected\u002Fgithub` | Issues, PRs, and sticky PR\u002Fissue comments |\n| `CheckRun`, `WorkflowDispatch` | `@effected\u002Fgithub` | Check runs, and dispatching\u002Fpolling another workflow |\n| `Attestation`, `ArtifactMetadata` | `@effected\u002Fgithub` | Uploading a signed attestation; artifact storage-record bookkeeping |\n| `TokenPermissions`, `CheckRunOutput`, `CommentMarker`, `BotIdentity`, `RepoRef` | `@effected\u002Fgithub` | Pure classes — no layer, no service, testable standalone |\n\nFull per-resource member signatures live in\n[`references\u002Fresources.md`](references\u002Fresources.md) — this table is the\nrouting index, not the catalogue.\n\n## Standards\n\n- **Route through the literal.** `client.request(route, params)` types both\n  `params` and the returned data from the route string alone — never invent\n  an `operation: string` wrapper, a callback, or a cast; a cast in\n  route-typed code is a defect, not a shortcut.\n- **Let the route decide what's paginatable, at compile time.** `RestRoute`\n  covers every documented route; `RestPaginatingRoute` is the narrower set\n  `client.paginate` actually accepts, so a non-paginating route handed to it\n  is rejected before the request is ever built. See\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md)\n  for the full type-level surface (`RestParams`, `RestData`, `RestExtras`).\n- **`requestDecoded` is an escape hatch from the route table, never from\n  typing.** Reach for it only when a route is absent from GitHub's OpenAPI\n  map or its live shape diverges, and always pass the schema — a shape\n  mismatch then fails typed (`kind: \"decode\"`) instead of trusting an\n  unchecked value.\n- **Resolve `Repo` per call, not once at construction.** The client is\n  stable and built once; which repository a call targets is the caller's\n  decision, and `Repo.provide(other)` must actually change it.\n- **One retry policy, wired at the client layer.** Every resource inherits\n  it; never give a resource its own retry logic, and never build a\n  proactive rate limiter — read `client.rateLimit` and pace yourself if you\n  need to.\n- **Catch on `GitHubError.kind`, never a resource-specific tag.** One\n  taxonomy, classified once by `GitHubError`'s shared classifier (`fromOctokit` \u002F `fromResponse`) — a\n  resource-specific error class has no successor to catch, and a real\n  survey of consumers found a resource-specific tag matched almost never.\n- **Prefer `GitBranch.upsert`\u002F`GitTag.upsert` over a hand-rolled\n  exists-then-create dance.** The library already resolves the\n  `alreadyExists` race with a `create`-then-reset recovery; a caller\n  catching `alreadyExists` itself is redoing work the library did for it.\n- **Forward `PageOptions` on every paginating call; never hard-code `{}`.**\n  `perPage` validates rather than clamps, so a caller asking for more than\n  100 per page has a bug worth failing on at the boundary, not discovering\n  in production.\n- **Wrap a resource's `layer` factory in an arrow.** `Layer.effect(this,\n  Effect.map(GitHubClient, (c) => make(c)))` — passing `make` directly\n  throws at import time from the static initializer, not at layer-build\n  time; every resource in the package follows this shape identically.\n- **Pure classes need no layer.** `TokenPermissions`, `CheckRunOutput`,\n  `CommentMarker`, `BotIdentity` and `RepoRef` reach nothing but `effect`;\n  construct and test them directly, and don't wrap one in a `Context.Service`\n  just to gain a double — there is nothing to mock.\n- **Every resource ships `makeTest`\u002F`layerTest`.** Every unstubbed member\n  dies **when run**, naming itself: calling it only builds the effect, and\n  the defect is in that effect's `Exit`, so assert with `Exit`\u002F`Cause.hasDies`\n  on the run, never with `assert.throws` around the call. A value member\n  (`GitHubRepository.settings`) is the dying effect itself and the double\n  still builds without it. Build a partial double from the member table, not\n  from a stack trace. The octokit `fetch`-hook harness that exercises the\n  real client end to end belongs to `testing-actions`.\n\n## REST calendar versioning\n\nVerified against the live API:\n\n- **The client pins `x-github-api-version: 2026-03-10` on every request.**\n  octokit itself sends no header, and without one GitHub serves its oldest\n  supported calendar version (`2022-11-28`, sunset 2028-03-10). The pin is a\n  `GitHubClientOptions.apiVersion` (and `GitHubAppOptions.apiVersion`)\n  option, which must be `YYYY-MM-DD` (anything else dies at construction).\n  **A GitHub Enterprise Server older than the default rejects it, so a client\n  pointed at one must set `apiVersion`** to the newest version that server\n  supports. The resolved value is `client.apiVersion`; calendar versions\n  compare correctly as strings (`client.apiVersion \u003C \"2026-03-10\"`).\n- **The route types describe a different version than the one the client\n  sends.** `client.request`'s params and `data` come from octokit's\n  generated types, which describe GitHub's oldest supported api-version, not\n  the default the client pins. So a route type can claim a field —\n  `merge_commit_sha` on a pull request, `has_downloads` on a repository —\n  that is `undefined` at runtime. Treat a field the pinned version removed\n  as absent whatever the type says, and check the version's breaking-change\n  list before reading a new one.\n- **A per-call header wins over the option.** `Attestation` pins its own\n  version per call through the typed `headers` extra (`RestExtras`, see\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md)),\n  and a client pinned elsewhere leaves it alone.\n- **On the old default, GitHub adds `Deprecation`\u002F`Sunset`\u002F`Link` headers\n  only on endpoints the new version CHANGED**, and octokit prints a warning\n  for each that cannot be silenced (its fetch wrapper logs via\n  `request.log ?? console`). That warning means \"this client is on an old\n  calendar version\", not \"this route is deprecated\"; the fix is the pin,\n  never a logging knob.\n- **A calendar-version change REMOVES response fields, and an `optionalKey`\n  decodes the absence clean.** `2026-03-10` removed `merge_commit_sha` from\n  pull request objects, so `PullRequestInfo.mergeCommitSha` is read from\n  GraphQL `mergeCommit.oid` instead, absent until the pull request merges\n  (never the speculative test-merge sha). `get`, `update` and `upsert` always\n  fill it; **`list` and `listAssociatedWithCommit` leave it absent unless\n  called with `mergeCommits: true`**, which costs one GraphQL call per 100\n  merged pull requests. All five carry `GitHubGraphQLError` in their error\n  channel. Before projecting a new\n  field off a REST response, check GitHub's breaking-change list for the\n  pinned version.\n\n## Footguns\n\n- `GitTag.latestSemver` picks the **highest parsed version**, not the most\n  recently created tag — in a monorepo with independently-versioned\n  packages the two disagree; scope with `prefix` to the package you mean.\n  See [`references\u002Fresources.md`](references\u002Fresources.md).\n- A route absent from the generated paginating-route map (e.g.\n  `GitHubCommit.changedFiles`) needs its own page source — never a manual\n  loop that reimplements pagination beside the one real engine. See\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md).\n- A hand-written route (release-asset upload, attestation upload) owns its\n  own query parameters in the URI template — a parameter passed only as an\n  argument, never templated, gets silently dropped by octokit rather than\n  rejected.\n- `GitCommit` and `GitHubCommit` are easy to confuse: writing a commit onto\n  a tree is `GitCommit` (Git Database API, no subprocess); reading what a\n  commit says is `GitHubCommit` (the higher-level commits API).\n\n## Out of scope — see the named skill\n\n- GitHub App authentication, token lifecycle, client constructors →\n  `github-app-tokens`.\n- Check runs and PR comments as a reporting workflow (as opposed to the raw\n  member catalogue) → `actions-reporting`.\n- The octokit `fetch`-hook test harness → `testing-actions`.\n- Attestation upload as part of a sign\u002FSBOM pipeline →\n  `supply-chain-attestation`.\n\n## Additional resources\n\n- [references\u002Fresources.md](references\u002Fresources.md) — the full per-resource\n  member catalogue: every service's methods, signatures and return shapes.\n  Load when: you need a specific method's signature or return type for any\n  of the fourteen resource services.\n- [references\u002Fpagination-retry-errors.md](references\u002Fpagination-retry-errors.md) —\n  the route-typing type-level surface (`RestParams`, `RestData`,\n  `RestExtras`, `RestPaginatingRoute`), the pagination engine's\n  request-budget semantics, the retry\u002Fbackoff schedule, and the full\n  `GitHubError`\u002F`GitHubGraphQLError` classification and GraphQL-document\n  mechanics. Load when: typing a route by hand, tuning a paginating call,\n  debugging a retry sequence, or classifying\u002Fcatching a GitHub error.\n","# `@effected\u002Fgithub`: calling GitHub from Effect v4\n\nTyped GitHub REST and GraphQL over `@octokit\u002Fcore`'s request surface, plus\nthe resource services (`GitBranch`, `PullRequest`, `GitHubIssue`, …) that\nturn raw endpoints into domain operations. General Effect v4 rules — service\nshapes, layer composition, memoization, `Schema.Class`, testing idioms —\nlive in `effect-v4-services-layers`, `effect-v4-schema`, `effect-v4-idioms`,\n`effect-v4-testing`; this skill states only what `@effected\u002Fgithub` does\ndifferently or as a worked instance.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `GitHubClient` (`.request`, `.requestDecoded`, `.paginate`, `.paginateStream`, `.graphql`, `.rateLimit`) | `import { GitHubClient } from \"@effected\u002Fgithub\"` | Calling any REST or GraphQL endpoint directly |\n| `Repo` | `@effected\u002Fgithub` | Scoping a program to an `owner`\u002F`repo` pair, or targeting a second repo mid-program |\n| `RetryPolicy` | `@effected\u002Fgithub` | Configuring the client's one retry\u002Fbackoff policy |\n| `GitHubError`, `GitHubGraphQLError` | `@effected\u002Fgithub` | Classifying or catching a REST\u002FGraphQL failure |\n| `GraphQLDocument` | `@effected\u002Fgithub` | Building a typed GraphQL query or mutation |\n| `GitBranch`, `GitTag`, `GitCommit` | `@effected\u002Fgithub` | Writing branches, tags, commits and trees through the Git Database API |\n| `GitHubCommit` | `@effected\u002Fgithub` | Reading commits as GitHub reports them (not the Git Database API) |\n| `GitHubRepository`, `GitHubContent` | `@effected\u002Fgithub` | Repo settings\u002Fdefault branch, or reading a file at a ref |\n| `GitHubIssue`, `PullRequest`, `PullRequestComment` | `@effected\u002Fgithub` | Issues, PRs, and sticky PR\u002Fissue comments |\n| `CheckRun`, `WorkflowDispatch` | `@effected\u002Fgithub` | Check runs, and dispatching\u002Fpolling another workflow |\n| `Attestation`, `ArtifactMetadata` | `@effected\u002Fgithub` | Uploading a signed attestation; artifact storage-record bookkeeping |\n| `TokenPermissions`, `CheckRunOutput`, `CommentMarker`, `BotIdentity`, `RepoRef` | `@effected\u002Fgithub` | Pure classes — no layer, no service, testable standalone |\n\nFull per-resource member signatures live in\n[`references\u002Fresources.md`](references\u002Fresources.md) — this table is the\nrouting index, not the catalogue.\n\n## Standards\n\n- **Route through the literal.** `client.request(route, params)` types both\n  `params` and the returned data from the route string alone — never invent\n  an `operation: string` wrapper, a callback, or a cast; a cast in\n  route-typed code is a defect, not a shortcut.\n- **Let the route decide what's paginatable, at compile time.** `RestRoute`\n  covers every documented route; `RestPaginatingRoute` is the narrower set\n  `client.paginate` actually accepts, so a non-paginating route handed to it\n  is rejected before the request is ever built. See\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md)\n  for the full type-level surface (`RestParams`, `RestData`, `RestExtras`).\n- **`requestDecoded` is an escape hatch from the route table, never from\n  typing.** Reach for it only when a route is absent from GitHub's OpenAPI\n  map or its live shape diverges, and always pass the schema — a shape\n  mismatch then fails typed (`kind: \"decode\"`) instead of trusting an\n  unchecked value.\n- **Resolve `Repo` per call, not once at construction.** The client is\n  stable and built once; which repository a call targets is the caller's\n  decision, and `Repo.provide(other)` must actually change it.\n- **One retry policy, wired at the client layer.** Every resource inherits\n  it; never give a resource its own retry logic, and never build a\n  proactive rate limiter — read `client.rateLimit` and pace yourself if you\n  need to.\n- **Catch on `GitHubError.kind`, never a resource-specific tag.** One\n  taxonomy, classified once by `GitHubError`'s shared classifier (`fromOctokit` \u002F `fromResponse`) — a\n  resource-specific error class has no successor to catch, and a real\n  survey of consumers found a resource-specific tag matched almost never.\n- **Prefer `GitBranch.upsert`\u002F`GitTag.upsert` over a hand-rolled\n  exists-then-create dance.** The library already resolves the\n  `alreadyExists` race with a `create`-then-reset recovery; a caller\n  catching `alreadyExists` itself is redoing work the library did for it.\n- **Forward `PageOptions` on every paginating call; never hard-code `{}`.**\n  `perPage` validates rather than clamps, so a caller asking for more than\n  100 per page has a bug worth failing on at the boundary, not discovering\n  in production.\n- **Wrap a resource's `layer` factory in an arrow.** `Layer.effect(this,\n  Effect.map(GitHubClient, (c) => make(c)))` — passing `make` directly\n  throws at import time from the static initializer, not at layer-build\n  time; every resource in the package follows this shape identically.\n- **Pure classes need no layer.** `TokenPermissions`, `CheckRunOutput`,\n  `CommentMarker`, `BotIdentity` and `RepoRef` reach nothing but `effect`;\n  construct and test them directly, and don't wrap one in a `Context.Service`\n  just to gain a double — there is nothing to mock.\n- **Every resource ships `makeTest`\u002F`layerTest`.** Every unstubbed member\n  dies **when run**, naming itself: calling it only builds the effect, and\n  the defect is in that effect's `Exit`, so assert with `Exit`\u002F`Cause.hasDies`\n  on the run, never with `assert.throws` around the call. A value member\n  (`GitHubRepository.settings`) is the dying effect itself and the double\n  still builds without it. Build a partial double from the member table, not\n  from a stack trace. The octokit `fetch`-hook harness that exercises the\n  real client end to end belongs to `testing-actions`.\n\n## REST calendar versioning\n\nVerified against the live API:\n\n- **The client pins `x-github-api-version: 2026-03-10` on every request.**\n  octokit itself sends no header, and without one GitHub serves its oldest\n  supported calendar version (`2022-11-28`, sunset 2028-03-10). The pin is a\n  `GitHubClientOptions.apiVersion` (and `GitHubAppOptions.apiVersion`)\n  option, which must be `YYYY-MM-DD` (anything else dies at construction).\n  **A GitHub Enterprise Server older than the default rejects it, so a client\n  pointed at one must set `apiVersion`** to the newest version that server\n  supports. The resolved value is `client.apiVersion`; calendar versions\n  compare correctly as strings (`client.apiVersion \u003C \"2026-03-10\"`).\n- **The route types describe a different version than the one the client\n  sends.** `client.request`'s params and `data` come from octokit's\n  generated types, which describe GitHub's oldest supported api-version, not\n  the default the client pins. So a route type can claim a field —\n  `merge_commit_sha` on a pull request, `has_downloads` on a repository —\n  that is `undefined` at runtime. Treat a field the pinned version removed\n  as absent whatever the type says, and check the version's breaking-change\n  list before reading a new one.\n- **A per-call header wins over the option.** `Attestation` pins its own\n  version per call through the typed `headers` extra (`RestExtras`, see\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md)),\n  and a client pinned elsewhere leaves it alone.\n- **On the old default, GitHub adds `Deprecation`\u002F`Sunset`\u002F`Link` headers\n  only on endpoints the new version CHANGED**, and octokit prints a warning\n  for each that cannot be silenced (its fetch wrapper logs via\n  `request.log ?? console`). That warning means \"this client is on an old\n  calendar version\", not \"this route is deprecated\"; the fix is the pin,\n  never a logging knob.\n- **A calendar-version change REMOVES response fields, and an `optionalKey`\n  decodes the absence clean.** `2026-03-10` removed `merge_commit_sha` from\n  pull request objects, so `PullRequestInfo.mergeCommitSha` is read from\n  GraphQL `mergeCommit.oid` instead, absent until the pull request merges\n  (never the speculative test-merge sha). `get`, `update` and `upsert` always\n  fill it; **`list` and `listAssociatedWithCommit` leave it absent unless\n  called with `mergeCommits: true`**, which costs one GraphQL call per 100\n  merged pull requests. All five carry `GitHubGraphQLError` in their error\n  channel. Before projecting a new\n  field off a REST response, check GitHub's breaking-change list for the\n  pinned version.\n\n## Footguns\n\n- `GitTag.latestSemver` picks the **highest parsed version**, not the most\n  recently created tag — in a monorepo with independently-versioned\n  packages the two disagree; scope with `prefix` to the package you mean.\n  See [`references\u002Fresources.md`](references\u002Fresources.md).\n- A route absent from the generated paginating-route map (e.g.\n  `GitHubCommit.changedFiles`) needs its own page source — never a manual\n  loop that reimplements pagination beside the one real engine. See\n  [`references\u002Fpagination-retry-errors.md`](references\u002Fpagination-retry-errors.md).\n- A hand-written route (release-asset upload, attestation upload) owns its\n  own query parameters in the URI template — a parameter passed only as an\n  argument, never templated, gets silently dropped by octokit rather than\n  rejected.\n- `GitCommit` and `GitHubCommit` are easy to confuse: writing a commit onto\n  a tree is `GitCommit` (Git Database API, no subprocess); reading what a\n  commit says is `GitHubCommit` (the higher-level commits API).\n\n## Out of scope — see the named skill\n\n- GitHub App authentication, token lifecycle, client constructors →\n  `github-app-tokens`.\n- Check runs and PR comments as a reporting workflow (as opposed to the raw\n  member catalogue) → `actions-reporting`.\n- The octokit `fetch`-hook test harness → `testing-actions`.\n- Attestation upload as part of a sign\u002FSBOM pipeline →\n  `supply-chain-attestation`.\n\n## Additional resources\n\n- [references\u002Fresources.md](references\u002Fresources.md) — the full per-resource\n  member catalogue: every service's methods, signatures and return shapes.\n  Load when: you need a specific method's signature or return type for any\n  of the fourteen resource services.\n- [references\u002Fpagination-retry-errors.md](references\u002Fpagination-retry-errors.md) —\n  the route-typing type-level surface (`RestParams`, `RestData`,\n  `RestExtras`, `RestPaginatingRoute`), the pagination engine's\n  request-budget semantics, the retry\u002Fbackoff schedule, and the full\n  `GitHubError`\u002F`GitHubGraphQLError` classification and GraphQL-document\n  mechanics. Load when: typing a route by hand, tuning a paginating call,\n  debugging a retry sequence, or classifying\u002Fcatching a GitHub error.\n",{"name":5,"description":7,"when_to_use":24},"client.request, requestDecoded, GitHubError, Repo, RetryPolicy, GraphQLDocument, TokenPermissions, CheckRunOutput, CommentMarker, GitBranch upsert, GitTag upsert, GitHub REST API, GitHub GraphQL API","main","11d6b3ae59538b0e16ad67c315ecb0c25fcb0125","plugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Fgithub-api",2,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected","https:\u002F\u002Fgithub.com\u002Fspencerbeggs","2026-11-14 07:03:25",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add spencerbeggs\u002Feffected --skill github-api",{"tool":38,"command":39},"bunx","bunx skills add spencerbeggs\u002Feffected --skill github-api",{"tool":41,"command":42},"pnpm","pnpm dlx skills add spencerbeggs\u002Feffected --skill github-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Fgithub-api\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fpagination-retry-errors.md","REFERENCE","参考文档",11559,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Fgithub-api\u002Freferences\u002Fpagination-retry-errors.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fresources.md",20806,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Fgithub-api\u002Freferences\u002Fresources.md",[57,64,71,78,85,92],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M780NVTD800KMFV869YNZED6","testing-actions","Use when writing or reviewing tests for @effected\u002Fgithub-actions, @effected\u002Fgithub, @effected\u002Fsbom or @effected\u002Fcommands — stubbing the GitHub API, writing a service's layerTest or makeTest double, testing the pre\u002Fmain\u002Fpost lifecycle through Action.run, or debugging why a test hits the real network or hangs.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Ftesting-actions\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M780NPDSGFC0FCP7696NW11J","supply-chain-attestation","Use when generating a CycloneDX SBOM, checking NTIA minimum elements, building an in-toto statement or a SLSA provenance predicate, signing into a Sigstore DSSE bundle, or uploading an attestation to GitHub.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsupply-chain-attestation\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M780NGP4QNZDH8T8Q8WZ18SA","structuring-an-action","Use when laying out a new GitHub Action repository on the @effected suite, deciding where a piece of code belongs (an entry point, a step, a shared service, a shim), or reviewing an existing action's file structure against the canonical shape.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fstructuring-an-action\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M780NCD52H1Y03FS83WJ8BT5","running-commands-and-tools","Use when running a subprocess in Effect v4, spawning a command, capturing stdout\u002Fstderr\u002Fexit code, checking whether a CLI tool is installed or which copy to run, running a package-manager script through the project's launcher, detaching a background process, or redacting a secret from argv or captured output.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Frunning-commands-and-tools\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M780N823DWNRMSY5X2NT5MSR","release-and-publish","Use when publishing a package to npm, reading the npm registry from Effect v4, checking whether a version is already published, cutting a release tag or GitHub release from an action, applying a release-age gate, or deriving tracking tags for GitHub Actions distribution.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Frelease-and-publish\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M780MXRF6H20KCESTSSFB3HQ","hardening-a-parser-port","Use when porting or writing a recursive-descent parser, lexer, or tree-walker over untrusted text in the @effected monorepo — the class of hardening the cloud reviewer scans for on every migration. Covers stack-overflow depth guards (on EVERY recursion surface, which a facade has N of — not two), numeric bound guards that must reject NaN and non-integers, code-point range checks scoped to formats with wide escapes, prototype-pollution, control-character rejection, and the invariant that malformed input must fail through the typed error channel, never as an unhandled defect.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fhardening-a-parser-port\u002FSKILL.md",[],[]]