[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BCRZZVRTCMEKPJHCVASES4":3,"skill-same:01M7BCRZZVRTCMEKPJHCVASES4":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7BCRZZVRTCMEKPJHCVASES4","gskill-install",null,"Install, locate, verify, or upgrade the GSKILL CLI (gskill) on Linux or macOS, then install the official gskill skill. Use when the user asks to install, set up, configure, or start using GSKILL, when a gskill command is not found, or when they ask which GSKILL version is installed or want a different one.","glapsfun\u002Fgskill","glapsfun","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F282230684?v=4","01M75YNBXMYFQQPK3TQSH4TP5N","01M75YNBY9K21N6S29TRQ96531",6,"MIT","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Fskills\u002Fgskill-install\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: gskill-install\ndescription: Install, locate, verify, or upgrade the GSKILL CLI (gskill) on Linux or macOS, then install the official gskill skill. Use when the user asks to install, set up, configure, or start using GSKILL, when a gskill command is not found, or when they ask which GSKILL version is installed or want a different one.\nlicense: MIT\ncompatibility: Linux or macOS on amd64 or arm64, with a shell tool. Installs GSKILL 0.12.0 or newer.\n---\n\n# Install GSKILL\n\nGSKILL is a package manager for agent skills, shipped as one `gskill` binary. This skill gets\na working `gskill` onto the machine, or confirms one is already there. It needs only a shell.\n\nWork through the steps in order. Stop at the first one that settles the request.\n\n## 1. Check for a working install\n\n```sh\ncommand -v gskill\ngskill --json version\n```\n\n- Both work and `version` is 0.12.0 or newer (a leading `v` is fine): GSKILL is ready. Report\n  the path and version and change nothing. Continue at step 7 only if the user asked for a\n  different version, else at step 8.\n- A version with a suffix, such as `v0.12.1-0.20261112112558-afb0314d28b3+dirty`, is a build\n  from source. Treat it as working and say so.\n- Not found: try the usual locations before installing anything:\n  `\"$HOME\u002F.local\u002Fbin\u002Fgskill\" version`, `\u002Fusr\u002Flocal\u002Fbin\u002Fgskill version`,\n  and, when `go` is installed, `\"$(go env GOPATH)\u002Fbin\u002Fgskill\" version`. If one works, it is installed but not on `PATH`;\n  go to step 6.\n- Older than 0.12.0: go to step 7.\n\n## 2. Check the platform\n\n```sh\nuname -s\nuname -m\n```\n\nGSKILL supports `Linux` and `Darwin` on `x86_64`, `amd64`, `aarch64`, or `arm64`. On\nanything else, stop and explain (see [troubleshooting](references\u002Ftroubleshooting.md)).\n\n## 3. Choose a method\n\nUse the method the user asked for. With no preference, use the install script: it needs only\n`curl` or `wget`, `tar`, and `sha256sum` or `shasum`, it verifies the checksum, and\n`gskill self upgrade` can update it later. Check what the machine has:\n\n```sh\nfor t in curl wget tar sha256sum shasum brew go npm node docker podman; do command -v \"$t\"; done\n```\n\nEach method's command, version pin, and needs are in\n[install methods](references\u002Finstall-methods.md). Use only those methods.\n\n## 4. Ask before changing the machine\n\nTell the user the method, the version, and the install directory, then wait for approval.\nAsk again, separately, before using `sudo` and before editing a shell profile. Skip a question\nonly when the request already answered it (\"install GSKILL with Homebrew\").\n\n## 5. Install and verify\n\nRun the chosen method's command. Then run the new binary by its absolute path:\n\n```sh\n\"$HOME\u002F.local\u002Fbin\u002Fgskill\" version\n```\n\nUse the path the installer printed. Success means it prints a version. When the user asked for\na version, confirm it matches; if it does not, say so.\n\n## 6. Make it usable in this session\n\n- If `command -v gskill` now finds it, nothing more is needed.\n- Otherwise, run every later command in this session by the absolute path. Many agent shells\n  start a fresh shell per command, so an `export PATH=...` does not carry over.\n- Give the user the line for new shells, and edit their profile only if they agree:\n  `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` (with the real directory).\n\n## 7. Upgrade or change version\n\nAsk GSKILL how it was installed and what an upgrade would do. Nothing changes in a dry run:\n\n```sh\ngskill --json --dry-run self upgrade\ngskill --json --dry-run self upgrade --to 0.12.0\n```\n\nRead `channel`, `installed_version`, `target_version`, `outcome`, and `next_command`:\n\n- `standalone` (install script or release archive): after approval, run\n  `gskill --yes self upgrade`, adding `--to X.Y.Z` for an exact version. Then run\n  `gskill version`.\n- `homebrew`, `npm-global`, `npm-project`, `npx`, `npm`, `go`, `container`: that tool owns the\n  install. Show `next_command` and run it only after approval. Never install a second copy\n  through another method.\n- `unknown`: GSKILL could not tell which tool owns it, so `next_command` lists every tool's\n  command. Show `executable` and ask which tool installed it.\n- `development`: a build from source, which cannot upgrade itself (exit 1). Explain and stop.\n\nExit code 8 means GSKILL printed the upgrade command and changed nothing. `self upgrade` never\ndowngrades; an older version means reinstalling with that method's exact-version form, after\nthe user agrees. Releases 0.9.0 and earlier have no `self upgrade`: rerun the install method.\n\n## 8. Install the usage skill\n\nWith GSKILL working, offer the official `gskill` skill so the user can manage skills by asking.\nFor this project:\n\n```sh\ngskill add github.com\u002Fglapsfun\u002Fgskill\u002Fskills\u002Fgskill --ref v0.13.0 --agent claude\n```\n\nReplace `claude` with the user's agent: `claude`, `codex`, `cursor`, `antigravity`,\n`opencode`, `openclaw`, or `hermes`. Add `--global` to install it for every project instead.\nAfter a project install for `hermes`, the user runs `hermes skills trust` once.\n\nDo not reinstall this skill (`gskill-install`) with GSKILL. It was copied in by hand, and GSKILL\nrefuses to overwrite a folder it does not manage.\n\n## 9. When something fails\n\nMatch the error in [troubleshooting](references\u002Ftroubleshooting.md) and give its next step. Do\nnot retry with `sudo` or another method without asking.\n\n## Report\n\nEnd with: the path and version of `gskill`, the method used (or \"already installed\"), and\nanything the user still has to do, such as the `PATH` line or `hermes skills trust`.\n","# Install GSKILL\n\nGSKILL is a package manager for agent skills, shipped as one `gskill` binary. This skill gets\na working `gskill` onto the machine, or confirms one is already there. It needs only a shell.\n\nWork through the steps in order. Stop at the first one that settles the request.\n\n## 1. Check for a working install\n\n```sh\ncommand -v gskill\ngskill --json version\n```\n\n- Both work and `version` is 0.12.0 or newer (a leading `v` is fine): GSKILL is ready. Report\n  the path and version and change nothing. Continue at step 7 only if the user asked for a\n  different version, else at step 8.\n- A version with a suffix, such as `v0.12.1-0.20261112112558-afb0314d28b3+dirty`, is a build\n  from source. Treat it as working and say so.\n- Not found: try the usual locations before installing anything:\n  `\"$HOME\u002F.local\u002Fbin\u002Fgskill\" version`, `\u002Fusr\u002Flocal\u002Fbin\u002Fgskill version`,\n  and, when `go` is installed, `\"$(go env GOPATH)\u002Fbin\u002Fgskill\" version`. If one works, it is installed but not on `PATH`;\n  go to step 6.\n- Older than 0.12.0: go to step 7.\n\n## 2. Check the platform\n\n```sh\nuname -s\nuname -m\n```\n\nGSKILL supports `Linux` and `Darwin` on `x86_64`, `amd64`, `aarch64`, or `arm64`. On\nanything else, stop and explain (see [troubleshooting](references\u002Ftroubleshooting.md)).\n\n## 3. Choose a method\n\nUse the method the user asked for. With no preference, use the install script: it needs only\n`curl` or `wget`, `tar`, and `sha256sum` or `shasum`, it verifies the checksum, and\n`gskill self upgrade` can update it later. Check what the machine has:\n\n```sh\nfor t in curl wget tar sha256sum shasum brew go npm node docker podman; do command -v \"$t\"; done\n```\n\nEach method's command, version pin, and needs are in\n[install methods](references\u002Finstall-methods.md). Use only those methods.\n\n## 4. Ask before changing the machine\n\nTell the user the method, the version, and the install directory, then wait for approval.\nAsk again, separately, before using `sudo` and before editing a shell profile. Skip a question\nonly when the request already answered it (\"install GSKILL with Homebrew\").\n\n## 5. Install and verify\n\nRun the chosen method's command. Then run the new binary by its absolute path:\n\n```sh\n\"$HOME\u002F.local\u002Fbin\u002Fgskill\" version\n```\n\nUse the path the installer printed. Success means it prints a version. When the user asked for\na version, confirm it matches; if it does not, say so.\n\n## 6. Make it usable in this session\n\n- If `command -v gskill` now finds it, nothing more is needed.\n- Otherwise, run every later command in this session by the absolute path. Many agent shells\n  start a fresh shell per command, so an `export PATH=...` does not carry over.\n- Give the user the line for new shells, and edit their profile only if they agree:\n  `export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"` (with the real directory).\n\n## 7. Upgrade or change version\n\nAsk GSKILL how it was installed and what an upgrade would do. Nothing changes in a dry run:\n\n```sh\ngskill --json --dry-run self upgrade\ngskill --json --dry-run self upgrade --to 0.12.0\n```\n\nRead `channel`, `installed_version`, `target_version`, `outcome`, and `next_command`:\n\n- `standalone` (install script or release archive): after approval, run\n  `gskill --yes self upgrade`, adding `--to X.Y.Z` for an exact version. Then run\n  `gskill version`.\n- `homebrew`, `npm-global`, `npm-project`, `npx`, `npm`, `go`, `container`: that tool owns the\n  install. Show `next_command` and run it only after approval. Never install a second copy\n  through another method.\n- `unknown`: GSKILL could not tell which tool owns it, so `next_command` lists every tool's\n  command. Show `executable` and ask which tool installed it.\n- `development`: a build from source, which cannot upgrade itself (exit 1). Explain and stop.\n\nExit code 8 means GSKILL printed the upgrade command and changed nothing. `self upgrade` never\ndowngrades; an older version means reinstalling with that method's exact-version form, after\nthe user agrees. Releases 0.9.0 and earlier have no `self upgrade`: rerun the install method.\n\n## 8. Install the usage skill\n\nWith GSKILL working, offer the official `gskill` skill so the user can manage skills by asking.\nFor this project:\n\n```sh\ngskill add github.com\u002Fglapsfun\u002Fgskill\u002Fskills\u002Fgskill --ref v0.13.0 --agent claude\n```\n\nReplace `claude` with the user's agent: `claude`, `codex`, `cursor`, `antigravity`,\n`opencode`, `openclaw`, or `hermes`. Add `--global` to install it for every project instead.\nAfter a project install for `hermes`, the user runs `hermes skills trust` once.\n\nDo not reinstall this skill (`gskill-install`) with GSKILL. It was copied in by hand, and GSKILL\nrefuses to overwrite a folder it does not manage.\n\n## 9. When something fails\n\nMatch the error in [troubleshooting](references\u002Ftroubleshooting.md) and give its next step. Do\nnot retry with `sudo` or another method without asking.\n\n## Report\n\nEnd with: the path and version of `gskill`, the method used (or \"already installed\"), and\nanything the user still has to do, such as the `PATH` line or `hermes skills trust`.\n",{"name":5,"license":14,"description":7,"compatibility":23},"Linux or macOS on amd64 or arm64, with a shell tool. Installs GSKILL 0.12.0 or newer.","main","2702faa678409c4e6cd27df406aef2901befaff5","skills\u002Fgskill-install",0,"https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill","https:\u002F\u002Fglapsfun.github.io\u002Fgskill\u002F","https:\u002F\u002Fgithub.com\u002Fglapsfun","https:\u002F\u002Fglaps.fun","2026-11-15 03:50:37",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add glapsfun\u002Fgskill --skill gskill-install",{"tool":39,"command":40},"bunx","bunx skills add glapsfun\u002Fgskill --skill gskill-install",{"tool":42,"command":43},"pnpm","pnpm dlx skills add glapsfun\u002Fgskill --skill gskill-install","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Fskills\u002Fgskill-install\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Finstall-methods.md","REFERENCE","参考文档",4874,"https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Fskills\u002Fgskill-install\u002Freferences\u002Finstall-methods.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Ftroubleshooting.md",3597,"https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Fskills\u002Fgskill-install\u002Freferences\u002Ftroubleshooting.md",[58,65,72,78,84,90],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M7BCS51KN1X31S36ZECP7Z70","gskill","Manage AI agent skills with the GSKILL CLI (gskill). Use when the user asks to find, add, install, restore, list, inspect, update, upgrade, verify, troubleshoot, or remove skills, or mentions skills.toml or skills-lock.json.","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Fskills\u002Fgskill\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":71},"01M75YPPEW0XRK8BT3MWCMRAMT","unicode","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Finternal\u002Fintegrity\u002Ftestdata\u002Fcompat\u002Ffixtures\u002Funicode\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":71},"01M75YPN3EZHFM5N6HC6XXJH94","hidden","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Finternal\u002Fintegrity\u002Ftestdata\u002Fcompat\u002Ffixtures\u002Fhidden\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":71},"01M75YPKDSWGM46Z7KAFMGJ784","executable","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Finternal\u002Fintegrity\u002Ftestdata\u002Fcompat\u002Ffixtures\u002Fexecutable\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":71},"01M75YPJ9KSJP7NPJ2Q4VR3TM8","excluded","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Finternal\u002Fintegrity\u002Ftestdata\u002Fcompat\u002Ffixtures\u002Fexcluded\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":71},"01M75YPGC8BSR149B85960CVV3","crlf","https:\u002F\u002Fgithub.com\u002Fglapsfun\u002Fgskill\u002Fblob\u002Fmain\u002Finternal\u002Fintegrity\u002Ftestdata\u002Fcompat\u002Ffixtures\u002Fcrlf\u002FSKILL.md",[],[]]