[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F8590WV755M2HVRHSJF3ME":3,"skill-same:01M7F8590WV755M2HVRHSJF3ME":46},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M7F8590WV755M2HVRHSJF3ME","releasing",null,"Use when asked to release, publish or tag a plugin or the Bifrost framework in this repository, to bump versions, push release tags (\u003Cmod>-v*, framework-v*), or when a Release Plugins \u002F Publish Bifrost Framework run on GitHub failed.","gidragir\u002Fclaude-mods","gidragir","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7879777?v=4","01M7F842DBWPHAR769D362Z1S5","Gidragir","01M7F842DZNA65ZSEQBZDP0A21",0,"MIT","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freleasing\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: releasing\ndescription: Use when asked to release, publish or tag a plugin or the Bifrost framework in this repository, to bump versions, push release tags (\u003Cmod>-v*, framework-v*), or when a Release Plugins \u002F Publish Bifrost Framework run on GitHub failed.\n---\n\n# Releasing plugins and the framework\n\n**Core principle:** a tag is a public, irreversible trigger. CI runs on a clean checkout that differs from\nthis machine (no `types\u002Fengine`, no `dist`, no `node_modules`, Linux, `bun install`), so local green is\nnot proof. Prove the release on a clean clone and with the workflows accepted **before** any tag leaves\nthe machine.\n\n## What ships where\n\n| Target | Version lives in | Tag | Workflow | Result |\n| --- | --- | --- | --- | --- |\n| plugin `\u003Cmod>` | `version` in `plugins\u002F\u003Cmod>\u002Fsrc\u002Fplugin.tsx` | `\u003Cmod>-v\u003Cversion>` | `release-plugins.yml` | orphan branch `release\u002F\u003Cmod>` |\n| framework | `packages\u002Fbifrost\u002Fpackage.json` + `## \u003Cversion>` in its `CHANGELOG.md` | `framework-v\u003Cversion>` | `publish-framework.yml` | `@gidragir\u002Fbifrost` on GitHub npm |\n\n`.claude-plugin\u002Fmarketplace.json` points at `release\u002F\u003Cmod>` and carries each plugin's version.\n\n## Procedure\n\n1. **Bump.** Every target whose files changed since its last tag gets a new version (`git tag -l '\u003Cmod>-v*'`).\n   Framework: move `Unreleased` in `CHANGELOG.md` into `## \u003Cversion>`. Plugins: `pnpm marketplace`.\n2. **Commit.** One scope per commit (`feat(bifrost)`, `feat(\u003Cmod>)`, `build`, `ci`), then the release commit\n   (`release: \u003Cmod> \u003Cversion>, …`) **last**: fixes found later go before a new release commit, not after it.\n3. **`pnpm release:check`** until it prints `Ready`. It replays the CI steps on a clean clone of HEAD, checks\n   versions against tags, the CHANGELOG section and marketplace.json, and runs actionlint when installed. It\n   prints the tags to push.\n4. **Push `main` alone**, wait ~20 s, `gh run list -L 5`. A run that failed in 0 s with \"This run likely failed\n   because of a workflow file issue\" means GitHub rejected a workflow: fix it, back to step 3.\n5. **Push the tags** printed in step 3 (`git tag -a \u003Ctag> -m …`, `git push origin \u003Ctags>`).\n6. **Verify the result, not the run:**\n   - plugin: `gh api \"repos\u002Fgidragir\u002Fclaude-mods\u002Fcontents\u002F.claude-plugin\u002Fplugin.json?ref=release\u002F\u003Cmod>\" --jq .content | base64 -d` shows the new version;\n   - framework: `gh run view \u003Cid> --log | grep \"+ @gidragir\u002Fbifrost@\"`.\n\n## When a release run fails after the tags are pushed\n\nDo not move, delete or re-push a tag. Fix on `main`, run `pnpm release:check`, push `main`, then rebuild\nfrom `main`: `gh workflow run release-plugins.yml -f plugin=\u003Cmod>` or `gh workflow run publish-framework.yml`.\nTell the user the release was built from `main`, not from the tag.\n\n## Known CI traps\n\n| Symptom | Cause |\n| --- | --- |\n| `build.mjs`: `Cannot find module 'claude-code'` | engine types are local only; the build must not need `types\u002Fengine` |\n| run fails in 0 s, \"workflow file issue\" | invalid workflow, e.g. `matrix.*` in a job-level `if` |\n| `with:` gets the literal `$VAR` | `with:` takes `${{ env.VAR }}`, not shell variables |\n| a step reads repo files before `actions\u002Fcheckout` | order of steps |\n\n## Red flags: stop\n\n- \"Tests pass locally, tag it\": run `pnpm release:check`.\n- Pushing `main` and tags in one command.\n- \"The run is green\": check the release branch or the published version.\n- Re-pointing a pushed tag to \"fix\" a release.\n","# Releasing plugins and the framework\n\n**Core principle:** a tag is a public, irreversible trigger. CI runs on a clean checkout that differs from\nthis machine (no `types\u002Fengine`, no `dist`, no `node_modules`, Linux, `bun install`), so local green is\nnot proof. Prove the release on a clean clone and with the workflows accepted **before** any tag leaves\nthe machine.\n\n## What ships where\n\n| Target | Version lives in | Tag | Workflow | Result |\n| --- | --- | --- | --- | --- |\n| plugin `\u003Cmod>` | `version` in `plugins\u002F\u003Cmod>\u002Fsrc\u002Fplugin.tsx` | `\u003Cmod>-v\u003Cversion>` | `release-plugins.yml` | orphan branch `release\u002F\u003Cmod>` |\n| framework | `packages\u002Fbifrost\u002Fpackage.json` + `## \u003Cversion>` in its `CHANGELOG.md` | `framework-v\u003Cversion>` | `publish-framework.yml` | `@gidragir\u002Fbifrost` on GitHub npm |\n\n`.claude-plugin\u002Fmarketplace.json` points at `release\u002F\u003Cmod>` and carries each plugin's version.\n\n## Procedure\n\n1. **Bump.** Every target whose files changed since its last tag gets a new version (`git tag -l '\u003Cmod>-v*'`).\n   Framework: move `Unreleased` in `CHANGELOG.md` into `## \u003Cversion>`. Plugins: `pnpm marketplace`.\n2. **Commit.** One scope per commit (`feat(bifrost)`, `feat(\u003Cmod>)`, `build`, `ci`), then the release commit\n   (`release: \u003Cmod> \u003Cversion>, …`) **last**: fixes found later go before a new release commit, not after it.\n3. **`pnpm release:check`** until it prints `Ready`. It replays the CI steps on a clean clone of HEAD, checks\n   versions against tags, the CHANGELOG section and marketplace.json, and runs actionlint when installed. It\n   prints the tags to push.\n4. **Push `main` alone**, wait ~20 s, `gh run list -L 5`. A run that failed in 0 s with \"This run likely failed\n   because of a workflow file issue\" means GitHub rejected a workflow: fix it, back to step 3.\n5. **Push the tags** printed in step 3 (`git tag -a \u003Ctag> -m …`, `git push origin \u003Ctags>`).\n6. **Verify the result, not the run:**\n   - plugin: `gh api \"repos\u002Fgidragir\u002Fclaude-mods\u002Fcontents\u002F.claude-plugin\u002Fplugin.json?ref=release\u002F\u003Cmod>\" --jq .content | base64 -d` shows the new version;\n   - framework: `gh run view \u003Cid> --log | grep \"+ @gidragir\u002Fbifrost@\"`.\n\n## When a release run fails after the tags are pushed\n\nDo not move, delete or re-push a tag. Fix on `main`, run `pnpm release:check`, push `main`, then rebuild\nfrom `main`: `gh workflow run release-plugins.yml -f plugin=\u003Cmod>` or `gh workflow run publish-framework.yml`.\nTell the user the release was built from `main`, not from the tag.\n\n## Known CI traps\n\n| Symptom | Cause |\n| --- | --- |\n| `build.mjs`: `Cannot find module 'claude-code'` | engine types are local only; the build must not need `types\u002Fengine` |\n| run fails in 0 s, \"workflow file issue\" | invalid workflow, e.g. `matrix.*` in a job-level `if` |\n| `with:` gets the literal `$VAR` | `with:` takes `${{ env.VAR }}`, not shell variables |\n| a step reads repo files before `actions\u002Fcheckout` | order of steps |\n\n## Red flags: stop\n\n- \"Tests pass locally, tag it\": run `pnpm release:check`.\n- Pushing `main` and tags in one command.\n- \"The run is green\": check the release branch or the published version.\n- Re-pointing a pushed tag to \"fix\" a release.\n",{"name":5,"description":7},"main","f6bd66d12222e4097404efee5bec1b8e1ec45482",".agents\u002Fskills\u002Freleasing","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Ftree\u002Fmain\u002Fplugins\u002Fref-pane","https:\u002F\u002Fgithub.com\u002Fgidragir","Everything as Code. Automating routines, refining AI workflows & building ergonomic developer tooling.","2026-10-22 19:56:40",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add gidragir\u002Fclaude-mods --skill releasing",{"tool":38,"command":39},"bunx","bunx skills add gidragir\u002Fclaude-mods --skill releasing",{"tool":41,"command":42},"pnpm","pnpm dlx skills add gidragir\u002Fclaude-mods --skill releasing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Freleasing\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M7F867TXYBJX53PWSD1CSWMC","__MOD_NAME__","__MOD_DESCRIPTION__","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Ftemplates\u002Fmod\u002Fskills\u002F__MOD_NAME__\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7F862R0J2CBSCDPCMMKFEZW","cross-mod","Hub for building plugins that run in both Claude Code and Google Antigravity (agy) with the Bifrost framework. Use when starting any plugin work in this repository to find the right specialized skill and the end-to-end workflow.","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Fskills\u002Fcross-mod\u002FSKILL.md",[],[],{"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},"01M7F85YREF3NBW5RFRDM2NSV4","ref-pane","Inspect and navigate project artifact references (such as RV-1, FB-2, T-3, ADR-4) in the Auxiliary Pane.","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Fplugins\u002Fref-pane\u002Fskills\u002Fref-pane\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},"01M7F85V4PPEFB8YC12ACYHRYN","bifrost-dev","Use when changing @gidragir\u002Fbifrost itself (packages\u002Fbifrost) - adding or renaming an export, Host member, primitive or component, changing codegen or the adapters, bumping its version or releasing it - and not when building a plugin under plugins\u002F\u003Cmod>.","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Fpackages\u002Fbifrost\u002F.agents\u002Fskills\u002Fbifrost-dev\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},"01M7F85KV1TAYNXEFZ1V8ZDYBF","bifrost-claude-adapter","Use when changing packages\u002Fbifrost\u002Fsrc\u002Fclaude or src\u002Fcli codegen, or when a generated hooks module fails claude plugin validate\u002Ftest for a reason the framework (not the plugin) causes - scanner errors, missing state contract keys, guard hooks, next(e) chaining.","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Fpackages\u002Fbifrost\u002F.agents\u002Fskills\u002Fbifrost-claude-adapter\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},"01M7F85EX7FQXHME8HYVQXFF32","bifrost-agy-adapter","Use when changing packages\u002Fbifrost\u002Fsrc\u002Fagy - the generated Antigravity aux-pane server, page runtime client.js, effects, token and preload contract, HTML renderer or bifrost.css - or when an agy pane misbehaves for every plugin rather than one.","https:\u002F\u002Fgithub.com\u002Fgidragir\u002Fclaude-mods\u002Fblob\u002Fmain\u002Fpackages\u002Fbifrost\u002F.agents\u002Fskills\u002Fbifrost-agy-adapter\u002FSKILL.md",[],[]]