[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M780NPDSGFC0FCP7696NW11J":3,"skill-same:01M780NPDSGFC0FCP7696NW11J":60},{"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},"01M780NPDSGFC0FCP7696NW11J","supply-chain-attestation",null,"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.","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\u002Fskills\u002Fsupply-chain-attestation\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: supply-chain-attestation\ndescription: 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.\nwhen_to_use: Sbom.generate, NtiaReport, InTotoStatement, SlsaProvenance, SigstoreSigner, OidcTokenIssuer, ActionsProvenance, ActionsIdentityToken, Attestation.upload\n---\n\n# Supply-chain attestation\n\nThe end-to-end pipeline spans **three packages**, which is why it is one\nskill rather than a single API reference: `@effected\u002Fsbom` (the SBOM\nemitter, the statement\u002Fprovenance models, the signer), `@effected\u002Fgithub-actions`\n(the OIDC token the signer needs), and `@effected\u002Fgithub` (the REST\nupload). None of the three packages import each other for this — the seams\nare the point. General Effect v4 service\u002Flayer and schema rules live in\n`effect-v4-services-layers`, `effect-v4-schema`, `effect-v4-testing`,\n`effected-packages`; this skill states only the supply-chain instance.\n\n`@effected\u002Fsbom` is two independent capabilities wearing one package:\nemitting an SBOM is pure computation over a manifest, and signing is\nnetwork-bound cryptography against Fulcio and Rekor. Every rule below\nexists to keep an SBOM-only consumer from reaching Sigstore's transport,\nand vice versa.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `Sbom.generate`, `.toJson`, `.write` | `import { Sbom } from \"@effected\u002Fsbom\"` | Emitting a CycloneDX SBOM document |\n| `SbomMetadataSource` | `@effected\u002Fsbom` | Deriving metadata\u002Fpurl\u002Froot component from a package manifest |\n| `NtiaReport` | `@effected\u002Fsbom` | Checking the seven NTIA minimum elements against a document |\n| `InTotoStatement`, `InTotoSubject`, `Sha256Digest` | `@effected\u002Fsbom` | Building an in-toto statement over a validated subject digest |\n| `SlsaProvenance` | `@effected\u002Fsbom` | Building the SLSA provenance predicate |\n| `ActionsProvenance` | `import { ActionsProvenance } from \"@effected\u002Fgithub-actions\"` | Capturing SLSA provenance from the runner's OIDC claims |\n| `IdentityToken`, `ActionsIdentityToken`, `OidcTokenIssuer` | `@effected\u002Foidc` \u002F `@effected\u002Fgithub-actions` | Wiring the workload identity token a signer needs |\n| `SigstoreSigner` | `@effected\u002Fsbom` | Signing a statement into a Sigstore DSSE bundle |\n| `Attestation.upload` | `import { Attestation } from \"@effected\u002Fgithub\"` | Uploading a signed bundle to GitHub |\n\n## Standards\n\n- **Keep the three packages seamless in both directions.** Nothing in\n  `@effected\u002Fsbom` imports `@effected\u002Fgithub-actions` or `@effected\u002Fgithub`\n  for this pipeline, and nothing in them imports `@effected\u002Fsbom` — a\n  consumer wires the pieces together at the composition root.\n- **`generate`\u002F`toJson` are total; `write` is the only fallible member.**\n  Treat any error surfacing from emission itself as a sign an error channel\n  crept back in that the model's validation should have made unreachable.\n- **Leave `supplier`\u002F`authors`\u002F`timestamp` explicit, never derived from the\n  manifest.** A manifest says who wrote the software, not who supplied it,\n  assembled the BOM, or when — deriving any of the three fabricates an\n  NTIA element.\n- **Let `NtiaReport.compliant` stay a derived getter, not a gate.** A\n  caller wanting a hard failure writes its own `Effect.fail` at its own\n  boundary; the report itself always succeeds.\n- **Build provenance through `ActionsProvenance.capture`, never by\n  hand-mapping OIDC claims yourself.** The hand mapping is eleven\n  same-typed string renames wide enough to transpose two fields and sign a\n  wrong attestation without a type error catching it.\n- **Ask the identity-token contract for a token; never take one as a sign\n  parameter.** The Sigstore audience constant is Sigstore's requirement,\n  not the caller's — keep it inside the contract, not spread across call\n  sites.\n- **Wire the shipped `ActionsIdentityToken` adapter inside Actions; never\n  hand-roll it.** Outside Actions, supply a token you already hold through\n  the static layer instead of reimplementing the contract.\n- **Never introduce a namespace object over this package's exports.** A\n  convenience `Sbom = { generate, sign }` object would make every SBOM-only\n  consumer reachable to Fulcio's transport, silently.\n- **Cross the `sbom` ↔ `github` attestation seam as a structural JSON\n  value, never as a shared class.** `Attestation.upload` types its bundle\n  parameter `unknown` on purpose — there is no edge between the two\n  packages in either direction.\n\n## Footguns\n\n- A license is an expression field, and CycloneDX renders it as three\n  different shapes depending on whether it's a catalog identifier, an\n  expression, or neither — emitting every value as an identifier produces\n  a document that looks right and fails validation. See\n  [`references\u002Fsbom-and-ntia.md`](references\u002Fsbom-and-ntia.md).\n- The purl's scope is the purl **namespace**, not part of the name — a\n  naive `encodeURIComponent` on the whole package name collapses the\n  namespace-separating slash and parses back wrong.\n- An unwitnessed Sigstore bundle has **no** `tlogEntries` key at all\n  (protobuf JSON omits empty repeated fields) — reading its length blindly\n  throws on a legitimately unwitnessed bundle.\n- Audit every ported error channel for whether it can actually fire — this\n  package deleted three that existed only because a since-removed\n  dependency might have thrown.\n\n## Additional resources\n\n- [references\u002Fsbom-and-ntia.md](references\u002Fsbom-and-ntia.md) — SBOM\n  emission mechanics, `SbomMetadataSource`'s explicit-only fields, the\n  license\u002Fpurl rendering traps, and the ported-error-channel audit. Load\n  when: emitting a document or debugging a license\u002Fpurl field.\n- [references\u002Fsigning-and-provenance.md](references\u002Fsigning-and-provenance.md) —\n  `InTotoStatement`\u002F`SlsaProvenance` construction, the `IdentityToken`\n  contract inversion and its Actions adapter, `SigstoreSigner`'s bundle\n  mechanics, the upload seam, and the testing recipes specific to signing.\n  Load when: building a statement, wiring identity tokens, signing, or\n  testing any of it.\n- [references\u002Fbundler-notes.md](references\u002Fbundler-notes.md) — the\n  reachability-confinement rules for `@sigstore\u002F*` and `Package`, the\n  comment-stripping order trap, and why `@cyclonedx\u002Fcyclonedx-library` is\n  absent (and when that reverses). Load when: auditing a dependency\n  decision or debugging a reachability-suite result.\n\n## Related skills\n\n`actions-runtime`, `actions-state-and-secrets`, `github-api` and\n`release-and-publish` cover the surrounding runner, state, REST-client and\nrelease-composition concerns this pipeline plugs into.\n","# Supply-chain attestation\n\nThe end-to-end pipeline spans **three packages**, which is why it is one\nskill rather than a single API reference: `@effected\u002Fsbom` (the SBOM\nemitter, the statement\u002Fprovenance models, the signer), `@effected\u002Fgithub-actions`\n(the OIDC token the signer needs), and `@effected\u002Fgithub` (the REST\nupload). None of the three packages import each other for this — the seams\nare the point. General Effect v4 service\u002Flayer and schema rules live in\n`effect-v4-services-layers`, `effect-v4-schema`, `effect-v4-testing`,\n`effected-packages`; this skill states only the supply-chain instance.\n\n`@effected\u002Fsbom` is two independent capabilities wearing one package:\nemitting an SBOM is pure computation over a manifest, and signing is\nnetwork-bound cryptography against Fulcio and Rekor. Every rule below\nexists to keep an SBOM-only consumer from reaching Sigstore's transport,\nand vice versa.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `Sbom.generate`, `.toJson`, `.write` | `import { Sbom } from \"@effected\u002Fsbom\"` | Emitting a CycloneDX SBOM document |\n| `SbomMetadataSource` | `@effected\u002Fsbom` | Deriving metadata\u002Fpurl\u002Froot component from a package manifest |\n| `NtiaReport` | `@effected\u002Fsbom` | Checking the seven NTIA minimum elements against a document |\n| `InTotoStatement`, `InTotoSubject`, `Sha256Digest` | `@effected\u002Fsbom` | Building an in-toto statement over a validated subject digest |\n| `SlsaProvenance` | `@effected\u002Fsbom` | Building the SLSA provenance predicate |\n| `ActionsProvenance` | `import { ActionsProvenance } from \"@effected\u002Fgithub-actions\"` | Capturing SLSA provenance from the runner's OIDC claims |\n| `IdentityToken`, `ActionsIdentityToken`, `OidcTokenIssuer` | `@effected\u002Foidc` \u002F `@effected\u002Fgithub-actions` | Wiring the workload identity token a signer needs |\n| `SigstoreSigner` | `@effected\u002Fsbom` | Signing a statement into a Sigstore DSSE bundle |\n| `Attestation.upload` | `import { Attestation } from \"@effected\u002Fgithub\"` | Uploading a signed bundle to GitHub |\n\n## Standards\n\n- **Keep the three packages seamless in both directions.** Nothing in\n  `@effected\u002Fsbom` imports `@effected\u002Fgithub-actions` or `@effected\u002Fgithub`\n  for this pipeline, and nothing in them imports `@effected\u002Fsbom` — a\n  consumer wires the pieces together at the composition root.\n- **`generate`\u002F`toJson` are total; `write` is the only fallible member.**\n  Treat any error surfacing from emission itself as a sign an error channel\n  crept back in that the model's validation should have made unreachable.\n- **Leave `supplier`\u002F`authors`\u002F`timestamp` explicit, never derived from the\n  manifest.** A manifest says who wrote the software, not who supplied it,\n  assembled the BOM, or when — deriving any of the three fabricates an\n  NTIA element.\n- **Let `NtiaReport.compliant` stay a derived getter, not a gate.** A\n  caller wanting a hard failure writes its own `Effect.fail` at its own\n  boundary; the report itself always succeeds.\n- **Build provenance through `ActionsProvenance.capture`, never by\n  hand-mapping OIDC claims yourself.** The hand mapping is eleven\n  same-typed string renames wide enough to transpose two fields and sign a\n  wrong attestation without a type error catching it.\n- **Ask the identity-token contract for a token; never take one as a sign\n  parameter.** The Sigstore audience constant is Sigstore's requirement,\n  not the caller's — keep it inside the contract, not spread across call\n  sites.\n- **Wire the shipped `ActionsIdentityToken` adapter inside Actions; never\n  hand-roll it.** Outside Actions, supply a token you already hold through\n  the static layer instead of reimplementing the contract.\n- **Never introduce a namespace object over this package's exports.** A\n  convenience `Sbom = { generate, sign }` object would make every SBOM-only\n  consumer reachable to Fulcio's transport, silently.\n- **Cross the `sbom` ↔ `github` attestation seam as a structural JSON\n  value, never as a shared class.** `Attestation.upload` types its bundle\n  parameter `unknown` on purpose — there is no edge between the two\n  packages in either direction.\n\n## Footguns\n\n- A license is an expression field, and CycloneDX renders it as three\n  different shapes depending on whether it's a catalog identifier, an\n  expression, or neither — emitting every value as an identifier produces\n  a document that looks right and fails validation. See\n  [`references\u002Fsbom-and-ntia.md`](references\u002Fsbom-and-ntia.md).\n- The purl's scope is the purl **namespace**, not part of the name — a\n  naive `encodeURIComponent` on the whole package name collapses the\n  namespace-separating slash and parses back wrong.\n- An unwitnessed Sigstore bundle has **no** `tlogEntries` key at all\n  (protobuf JSON omits empty repeated fields) — reading its length blindly\n  throws on a legitimately unwitnessed bundle.\n- Audit every ported error channel for whether it can actually fire — this\n  package deleted three that existed only because a since-removed\n  dependency might have thrown.\n\n## Additional resources\n\n- [references\u002Fsbom-and-ntia.md](references\u002Fsbom-and-ntia.md) — SBOM\n  emission mechanics, `SbomMetadataSource`'s explicit-only fields, the\n  license\u002Fpurl rendering traps, and the ported-error-channel audit. Load\n  when: emitting a document or debugging a license\u002Fpurl field.\n- [references\u002Fsigning-and-provenance.md](references\u002Fsigning-and-provenance.md) —\n  `InTotoStatement`\u002F`SlsaProvenance` construction, the `IdentityToken`\n  contract inversion and its Actions adapter, `SigstoreSigner`'s bundle\n  mechanics, the upload seam, and the testing recipes specific to signing.\n  Load when: building a statement, wiring identity tokens, signing, or\n  testing any of it.\n- [references\u002Fbundler-notes.md](references\u002Fbundler-notes.md) — the\n  reachability-confinement rules for `@sigstore\u002F*` and `Package`, the\n  comment-stripping order trap, and why `@cyclonedx\u002Fcyclonedx-library` is\n  absent (and when that reverses). Load when: auditing a dependency\n  decision or debugging a reachability-suite result.\n\n## Related skills\n\n`actions-runtime`, `actions-state-and-secrets`, `github-api` and\n`release-and-publish` cover the surrounding runner, state, REST-client and\nrelease-composition concerns this pipeline plugs into.\n",{"name":5,"description":7,"when_to_use":24},"Sbom.generate, NtiaReport, InTotoStatement, SlsaProvenance, SigstoreSigner, OidcTokenIssuer, ActionsProvenance, ActionsIdentityToken, Attestation.upload","main","11d6b3ae59538b0e16ad67c315ecb0c25fcb0125","plugin\u002Fskills\u002Fsupply-chain-attestation",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 supply-chain-attestation",{"tool":38,"command":39},"bunx","bunx skills add spencerbeggs\u002Feffected --skill supply-chain-attestation",{"tool":41,"command":42},"pnpm","pnpm dlx skills add spencerbeggs\u002Feffected --skill supply-chain-attestation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsupply-chain-attestation\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fbundler-notes.md","REFERENCE","参考文档",3128,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsupply-chain-attestation\u002Freferences\u002Fbundler-notes.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fsbom-and-ntia.md",5747,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsupply-chain-attestation\u002Freferences\u002Fsbom-and-ntia.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fsigning-and-provenance.md",8727,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fsupply-chain-attestation\u002Freferences\u002Fsigning-and-provenance.md",[61,68,75,82,89,96],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"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":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"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":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"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":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"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":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"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",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M780MR9HZ5QVY1B42803G9AF","github-app-tokens","Use when a GitHub credential needs to come into existence, live somewhere, and die — constructing a client from a plain token or a GitHub App, or wiring GitHubToken's provision\u002Fread\u002FclientLayer\u002Fdispose lifecycle across an Action's pre\u002Fmain\u002Fpost phases.","https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fgithub-app-tokens\u002FSKILL.md",[],[]]