[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77ZVRQS40J3F8DGJEP7PC1G":3,"skill-same:01M77ZVRQS40J3F8DGJEP7PC1G":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},"01M77ZVRQS40J3F8DGJEP7PC1G","actions-inputs-outputs",null,"Use when reading a GitHub Action's inputs through ActionInput, writing outputs through ActionOutputs, or designing a machine-readable, schema-backed output contract for a workflow or LLM consumer.","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\u002Factions-inputs-outputs\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: actions-inputs-outputs\ndescription: Use when reading a GitHub Action's inputs through ActionInput, writing outputs through ActionOutputs, or designing a machine-readable, schema-backed output contract for a workflow or LLM consumer.\nwhen_to_use: action input, action output, INPUT_ mangling, action.yml sync, ActionManifest, runner-shaped inputs, ConfigError, dry-run silently defaulted, runner file delimiter, setJson, output contract, JSON Schema drift test, ActionInputs service, ActionInputError, schemastore, SchemaPipeline, published output schema, versioned schema\n---\n\n# Actions inputs & outputs\n\nThe runner-file I\u002FO surface of `@effected\u002Fgithub-actions`: reading what a workflow author configured, and publishing what the action produced. Both modules fail through structured errors, and neither ever spells a runner variable name — that mangling lives in exactly one function per direction.\n\nFor everything else the runtime provides — `ActionState`, `Secret`, `GitHubToken`, the default layer composition — see `actions-runtime`. For `Redacted`\u002Fmasking mechanics and cross-phase state, see `actions-state-and-secrets`. For the job summary sink and log annotations beyond `setFailed`\u002F`setSecret`, see `actions-reporting`. For test doubles, see `testing-actions`. General Effect v4 `Config`\u002F`Schema` rules live in `effect-v4-schema` and `effect-v4-idioms`; this skill carries only the Actions-specific instance of those rules.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `ActionInput.string` \u002F `.boolean` \u002F `.integer` \u002F `.redacted` | `import { ActionInput } from \"@effected\u002Fgithub-actions\"` | reading a single-value input with the runner's own parsing rules |\n| `ActionInput.lines` \u002F `.list` \u002F `.pairs` | same | reading a multi-value or key\u002Fvalue input without hand-rolling a splitter |\n| `ActionInput.schema(name, schema)` | same | an input carries genuinely nested structure and is worth decoding as JSON |\n| `ActionOutputs.set` \u002F `.exportVariable` \u002F `.addPath` | `import { ActionOutputs } from \"@effected\u002Fgithub-actions\"` | publishing a plain output, an env var for later steps, or a PATH prefix |\n| `ActionOutputs.setJson` | same | publishing a structured output through a `Schema` codec |\n| `ActionOutputs.summary` | same | appending to the job summary (full sink detail in `actions-reporting`) |\n| `ActionOutputs.setFailed` \u002F `.setSecret` | same | rendering `::error::`\u002F`::add-mask::` directly, outside the normal failure path |\n\n## Standards\n\n- **Read every input through `ActionInput`'s accessors — never a bare `Config.String`\u002F`Config.Boolean` spelled by hand.** The accessors own the `INPUT_` name mangling (uppercase, spaces to underscores, dashes survive) and carry the parsing and typed `ConfigError`s a bare read cannot. `ActionRuntime.layer` installs a provider that also resolves a bare flat name through the same derivation, but a program that reads inputs directly still owns none of the parsing — write `ActionInput.boolean(\"dry-run\")`, not `INPUT_DRY-RUN` spelled anywhere.\n- **Prove a present-but-malformed input fails through `withDefault`.** `Config.withDefault`\u002F`Config.option` classify a *missing* key as absent, but a present, unparseable value still fails — `Config` tracks input evidence itself, not the issue (`InvalidValue` carries no `actual` field to build a stale \"missing\" classification from; its constructor is `(annotations?, input?, options?)`). A present-but-malformed value fails even under a default: keep the regression test (`config.pipe(Config.withDefault(x))` fails, not falls back, on malformed input). See `references\u002Finput-validation.md`.\n- **Design a state or output field's encoded form as plain JSON before deciding how to test it.** A `setJson` payload, a runner-file write, and cross-phase state all round-trip through `JSON.stringify`\u002F`parse`; a value whose encoded form isn't a JSON primitive fails one step later than the mistake.\n- **Build a `CheckRunOutput`\u002F`ActionOutputs` object with a conditional spread when a field is `optionalKey`.** The key may be omitted; the value must never be an explicit `undefined` passed to it.\n- **Publish a `setJson` contract from a schema the projection also produces from — never duplicate the shape.** See `references\u002Foutput-contracts.md`.\n- **An empty string reads as absent, everywhere in this surface.** The runner sets an unsupplied optional input to `\"\"`; treat that the same as a missing key, not a supplied empty value.\n\n## Footguns\n\n- A bare `Config.String(\"dry-run\")` can typecheck, compile clean, and pass a test suite whose injected `ConfigProvider` is keyed by the plain name — and still read nothing against the real runner, silently falling back to a default. See `references\u002Finput-validation.md`.\n- GitHub uppercases and replaces spaces with underscores in a runner variable name, but dashes survive — a hand-written test key with underscores where dashes belong reads nothing and passes for the wrong reason. See `references\u002Finput-validation.md`.\n- `ActionEnvironment` snapshots `process.env` once at layer construction, so a value exported mid-run through `exportVariable` is never observed by the same process's own reader — that's GitHub's model, not a bug. Assert against the written `GITHUB_ENV` file, not a same-process readback.\n- A runner-file block write uses a derived delimiter, never a fixed or random one — a value containing an un-derived delimiter would terminate its own block early and corrupt every entry written after it in the same file.\n\n## Additional resources\n\n- [references\u002Finput-validation.md](references\u002Finput-validation.md) — the `Config.withDefault` trap in full, the `inputVariable` mangling rule with its dash\u002Funderscore trap, the two config providers (`layerDefault` vs the record-backed `layer()`), the three-way sync discipline between `action.yml`, an input names tuple and the decoded shape, and `ActionManifest` (`diff` for the name check, `runnerInputs` for the runner-shaped test environment) so none of it is hand-rolled. Load when: designing or reviewing an inputs module, or chasing why a malformed input silently defaulted.\n- [references\u002Foutput-contracts.md](references\u002Foutput-contracts.md) — `ActionOutputs`' full member table, the runner-file delimiter and name-validation rules, and the pattern for a `setJson` payload consumed outside the action: schema as encoder, pure projections, where the document's title and description go on a `Schema.Class`, publication through a `HostedSchema` identity and `lib\u002Fscripts\u002Fschemastore.config.ts` with the `schemastore` command (a `published` document refuses a contract change at its current label), versioned publication, which custom annotation keys survive, and `schema:check` as the drift gate. Load when: authoring or reviewing `ActionOutputs` usage, or a `setJson` output meant for a downstream job, a bot, or an LLM reader.\n- [references\u002Fjson-contracts.md](references\u002Fjson-contracts.md) — when a JSON-shaped input earns a published, `@effected\u002Fschemastore`-generated JSON Schema versus staying an internal `ActionInput.schema` decode. Load when: an input is genuinely nested structure rather than a flat or line-list value, and workflow authors would benefit from editor completion on it.\n","# Actions inputs & outputs\n\nThe runner-file I\u002FO surface of `@effected\u002Fgithub-actions`: reading what a workflow author configured, and publishing what the action produced. Both modules fail through structured errors, and neither ever spells a runner variable name — that mangling lives in exactly one function per direction.\n\nFor everything else the runtime provides — `ActionState`, `Secret`, `GitHubToken`, the default layer composition — see `actions-runtime`. For `Redacted`\u002Fmasking mechanics and cross-phase state, see `actions-state-and-secrets`. For the job summary sink and log annotations beyond `setFailed`\u002F`setSecret`, see `actions-reporting`. For test doubles, see `testing-actions`. General Effect v4 `Config`\u002F`Schema` rules live in `effect-v4-schema` and `effect-v4-idioms`; this skill carries only the Actions-specific instance of those rules.\n\n## What you have\n\n| Construct | Import | Reach for it when |\n| --- | --- | --- |\n| `ActionInput.string` \u002F `.boolean` \u002F `.integer` \u002F `.redacted` | `import { ActionInput } from \"@effected\u002Fgithub-actions\"` | reading a single-value input with the runner's own parsing rules |\n| `ActionInput.lines` \u002F `.list` \u002F `.pairs` | same | reading a multi-value or key\u002Fvalue input without hand-rolling a splitter |\n| `ActionInput.schema(name, schema)` | same | an input carries genuinely nested structure and is worth decoding as JSON |\n| `ActionOutputs.set` \u002F `.exportVariable` \u002F `.addPath` | `import { ActionOutputs } from \"@effected\u002Fgithub-actions\"` | publishing a plain output, an env var for later steps, or a PATH prefix |\n| `ActionOutputs.setJson` | same | publishing a structured output through a `Schema` codec |\n| `ActionOutputs.summary` | same | appending to the job summary (full sink detail in `actions-reporting`) |\n| `ActionOutputs.setFailed` \u002F `.setSecret` | same | rendering `::error::`\u002F`::add-mask::` directly, outside the normal failure path |\n\n## Standards\n\n- **Read every input through `ActionInput`'s accessors — never a bare `Config.String`\u002F`Config.Boolean` spelled by hand.** The accessors own the `INPUT_` name mangling (uppercase, spaces to underscores, dashes survive) and carry the parsing and typed `ConfigError`s a bare read cannot. `ActionRuntime.layer` installs a provider that also resolves a bare flat name through the same derivation, but a program that reads inputs directly still owns none of the parsing — write `ActionInput.boolean(\"dry-run\")`, not `INPUT_DRY-RUN` spelled anywhere.\n- **Prove a present-but-malformed input fails through `withDefault`.** `Config.withDefault`\u002F`Config.option` classify a *missing* key as absent, but a present, unparseable value still fails — `Config` tracks input evidence itself, not the issue (`InvalidValue` carries no `actual` field to build a stale \"missing\" classification from; its constructor is `(annotations?, input?, options?)`). A present-but-malformed value fails even under a default: keep the regression test (`config.pipe(Config.withDefault(x))` fails, not falls back, on malformed input). See `references\u002Finput-validation.md`.\n- **Design a state or output field's encoded form as plain JSON before deciding how to test it.** A `setJson` payload, a runner-file write, and cross-phase state all round-trip through `JSON.stringify`\u002F`parse`; a value whose encoded form isn't a JSON primitive fails one step later than the mistake.\n- **Build a `CheckRunOutput`\u002F`ActionOutputs` object with a conditional spread when a field is `optionalKey`.** The key may be omitted; the value must never be an explicit `undefined` passed to it.\n- **Publish a `setJson` contract from a schema the projection also produces from — never duplicate the shape.** See `references\u002Foutput-contracts.md`.\n- **An empty string reads as absent, everywhere in this surface.** The runner sets an unsupplied optional input to `\"\"`; treat that the same as a missing key, not a supplied empty value.\n\n## Footguns\n\n- A bare `Config.String(\"dry-run\")` can typecheck, compile clean, and pass a test suite whose injected `ConfigProvider` is keyed by the plain name — and still read nothing against the real runner, silently falling back to a default. See `references\u002Finput-validation.md`.\n- GitHub uppercases and replaces spaces with underscores in a runner variable name, but dashes survive — a hand-written test key with underscores where dashes belong reads nothing and passes for the wrong reason. See `references\u002Finput-validation.md`.\n- `ActionEnvironment` snapshots `process.env` once at layer construction, so a value exported mid-run through `exportVariable` is never observed by the same process's own reader — that's GitHub's model, not a bug. Assert against the written `GITHUB_ENV` file, not a same-process readback.\n- A runner-file block write uses a derived delimiter, never a fixed or random one — a value containing an un-derived delimiter would terminate its own block early and corrupt every entry written after it in the same file.\n\n## Additional resources\n\n- [references\u002Finput-validation.md](references\u002Finput-validation.md) — the `Config.withDefault` trap in full, the `inputVariable` mangling rule with its dash\u002Funderscore trap, the two config providers (`layerDefault` vs the record-backed `layer()`), the three-way sync discipline between `action.yml`, an input names tuple and the decoded shape, and `ActionManifest` (`diff` for the name check, `runnerInputs` for the runner-shaped test environment) so none of it is hand-rolled. Load when: designing or reviewing an inputs module, or chasing why a malformed input silently defaulted.\n- [references\u002Foutput-contracts.md](references\u002Foutput-contracts.md) — `ActionOutputs`' full member table, the runner-file delimiter and name-validation rules, and the pattern for a `setJson` payload consumed outside the action: schema as encoder, pure projections, where the document's title and description go on a `Schema.Class`, publication through a `HostedSchema` identity and `lib\u002Fscripts\u002Fschemastore.config.ts` with the `schemastore` command (a `published` document refuses a contract change at its current label), versioned publication, which custom annotation keys survive, and `schema:check` as the drift gate. Load when: authoring or reviewing `ActionOutputs` usage, or a `setJson` output meant for a downstream job, a bot, or an LLM reader.\n- [references\u002Fjson-contracts.md](references\u002Fjson-contracts.md) — when a JSON-shaped input earns a published, `@effected\u002Fschemastore`-generated JSON Schema versus staying an internal `ActionInput.schema` decode. Load when: an input is genuinely nested structure rather than a flat or line-list value, and workflow authors would benefit from editor completion on it.\n",{"name":5,"description":7,"when_to_use":24},"action input, action output, INPUT_ mangling, action.yml sync, ActionManifest, runner-shaped inputs, ConfigError, dry-run silently defaulted, runner file delimiter, setJson, output contract, JSON Schema drift test, ActionInputs service, ActionInputError, schemastore, SchemaPipeline, published output schema, versioned schema","main","11d6b3ae59538b0e16ad67c315ecb0c25fcb0125","plugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Factions-inputs-outputs",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 actions-inputs-outputs",{"tool":38,"command":39},"bunx","bunx skills add spencerbeggs\u002Feffected --skill actions-inputs-outputs",{"tool":41,"command":42},"pnpm","pnpm dlx skills add spencerbeggs\u002Feffected --skill actions-inputs-outputs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Factions-inputs-outputs\u002FSKILL.md",true,[46,52,56],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Finput-validation.md","REFERENCE","参考文档",11040,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Factions-inputs-outputs\u002Freferences\u002Finput-validation.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fjson-contracts.md",2747,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Factions-inputs-outputs\u002Freferences\u002Fjson-contracts.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Foutput-contracts.md",21226,"https:\u002F\u002Fgithub.com\u002Fspencerbeggs\u002Feffected\u002Fblob\u002Fmain\u002Fplugin\u002Fbuilds\u002Fclaude\u002Fskills\u002Factions-inputs-outputs\u002Freferences\u002Foutput-contracts.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},"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":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},"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":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},"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":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},"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":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},"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",[],[]]