gh-skill — скилл для Claude Code: управление навыками
Скилл gh-skill для Claude Code помогает искать, просматривать, устанавливать, обновлять и публиковать Agent Skills. Агент запускает его для управления набором навыков из GitHub-репозиториев.
MIT 164 установок ★ 47 132 обновлён 2026-10-24
npx skills add cli/cli --skill gh-skill -a claude-codeЧто делает gh-skill
gh-skill описывает работу с командой gh skill: она ищет навыки в GitHub, показывает содержимое перед установкой, устанавливает и обновляет их. Для установки можно выбрать хост через --agent, область project или user, а также закрепить версию с помощью --pin.
Команда публикует репозиторий как источник навыков: проверяет структуру SKILL.md, а затем может создать GitHub-релиз. Публикация добавляет тему agent-skills и отправляет незапушенные коммиты. В неинтерактивном режиме установка по умолчанию нацелена на github-copilot, поэтому для другого агента задают --agent.
Для локальной установки предусмотрен флаг --from-local; --pin с ним несовместим. Скилл также объясняет, как предварительно проверить публикацию через --dry-run и исправить метаданные установки через --fix.
Какие задачи решает
- найти навык в GitHub по запросу
- просмотреть содержимое навыка до установки
- установить навык для выбранного агента и закрепить версию
- обновить установленные навыки
- проверить и опубликовать репозиторий с навыками
Примеры запросов агенту
- Найди в GitHub скиллы для работы с тестами и покажи результаты в JSON.
- Просмотри
cli/cliи установиgh-skillдля Claude Code с закреплённой версией. - Проверь репозиторий с навыками и подготовь публикацию с тегом
v1.0.0.
Как установить gh-skill
1Через Skills CLI (Vercel)
npx skills add cli/cli --skill gh-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/gh-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gh-skill/
1Через Skills CLI (Vercel)
npx skills add cli/cli --skill gh-skill -a codex2Вручную: положить файлы
.agents/skills/gh-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cli/cli --skill gh-skill -a cursor2Вручную: положить файлы
.cursor/skills/gh-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cli/cli skills/gh-skill2Вручную: положить файлы
.github/skills/gh-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add cli/cli --skill gh-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/cli/cli --path skills/gh-skillВручную: положить файлы
.devin/skills/gh-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cli/cli --skill gh-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gh-skill
Как установить gh-skill в Claude Code?
Выполни npx skills add cli/cli --skill gh-skill -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/gh-skill/SKILL.md.
Что делает gh-skill?
Он помогает агенту искать, просматривать, устанавливать и обновлять Agent Skills из GitHub, а также публиковать репозитории как источники навыков.
Как выбрать агента для установки навыка?
Укажи целевой хост флагом --agent, например --agent claude-code или --agent cursor. В неинтерактивном режиме без этого флага используется github-copilot.
Исходный текст
SKILL.md · MIT
--- name: gh-skill description: Manage agent skills with gh skill. Use this skill to discover, preview, install, update, and publish Agent Skills so an agent can self-manage the skills available in its environment. --- # Managing skills with `gh skill` `gh skill` installs, previews, searches, updates, and publishes [Agent Skills](https://agentskills.io). An agent can use it to keep its own skill set in sync with one or more GitHub repositories. The command is also aliased as `gh skills`. Prefer the canonical singular `gh skill` in scripts and docs. ## Search ```bash gh skill search <query> # free-text search gh skill search <query> --owner <org> # restrict to one owner gh skill search <query> --limit 20 --page 2 gh skill search <query> --json skillName,repo,description ``` ## Preview before installing ```bash gh skill preview <owner>/<repo> <skill-name> gh skill preview <owner>/<repo> <skill-name>@v1.2.0 # pin a version ``` ## Install ```bash gh skill install <owner>/<repo> <skill-name> gh skill install <owner>/<repo> <skill-name>@v1.2.0 gh skill install <owner>/<repo> skills/<scope>/<skill-name> # exact path, fastest gh skill install ./local-skills-repo --from-local ``` `<owner>/<repo>` and `<skill-name>` are both required. Useful flags: - `--agent <id>` - target host (e.g. `github-copilot`, `claude-code`, `cursor`, `codex`, `gemini-cli`). Repeat for multiple. Default is `github-copilot` when non-interactive. You should know what agent you are, so set this appropriately to install for yourself. - `--scope project|user` - `project` (default) writes inside the current git repo; `user` writes to the home directory and applies everywhere. - `--pin <ref>` - pin to a tag, branch, or commit SHA. Mutually exclusive with `--from-local` and with inline `@version` syntax. - `--allow-hidden-dirs` - also discover skills under dot-directories such as `.claude/skills/`. Don't use this unless you need to, it comes with risks. - `--force` - overwrite an existing install. ## Update ```bash gh skill update --all # update every installed skill gh skill update <skill> # update one gh skill update <skill> --force gh skill update --unpin # drop the pin and move to latest ``` ## Publish Publishing turns a repo into a discoverable skill source. Skills are discovered with these conventions: - `skills/<name>/SKILL.md` - `skills/<scope>/<name>/SKILL.md` - `<name>/SKILL.md` (root-level) - `plugins/<scope>/skills/<name>/SKILL.md` Each `SKILL.md` needs YAML frontmatter: ```yaml --- name: my-skill # must equal the directory name description: One sentence... # required, recommended <= 1024 chars license: MIT # optional but recommended --- ``` ### Validate, then publish ```bash gh skill publish --dry-run # validate only, no release gh skill publish --dry-run ./path/to/repo # validate a specific dir gh skill publish --fix # auto-strip install metadata gh skill publish --tag v1.0.0 # non-interactive publish gh skill publish # interactive publish flow ``` `--fix` and `--dry-run` are mutually exclusive. `--fix` only rewrites install-injected `metadata.github-*` keys and does not publish; commit the result and re-run `publish`. The publish flow will: 1. Add the `agent-skills` topic to the repo (so search can find it). 2. Use `--tag` (or prompt for one in a TTY). 3. Auto-push any unpushed commits. 4. Create a GitHub release with auto-generated notes. Always pass `--tag` so it doesn't fall through to the interactive flow. ## Self-management pattern for agents A reasonable loop: 1. `gh skill search <topic> --json skillName,repo,namespace` 2. `gh skill preview <repo> <skill>` to inspect the `SKILL.md`. 3. `gh skill install <repo> <skill> --agent <host> --pin <ref>` for a reproducible install. 4. Periodically `gh skill update --all` to refresh.
© cli · MIT · cli/cli