{
  "slug": "gh-skill-discovers-and-installs-skills-for-agent-hosts-27c8f963eee7",
  "title": "gh skill discovers and installs skills for agent hosts",
  "tools": [
    "gh"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-16T17:24:41.000Z",
  "announced_at": "2026-04-16T17:24:41.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When installing a repository skill for your coding host, preview it first, then run `gh skill install <OWNER>/<REPOSITORY> <SKILL> --agent <HOST> --scope <project|user>`. Search for candidates with `gh skill search <QUERY>`; skill commands are documented as preview features.",
    "examples": [
      "gh skill search mcp-apps",
      "gh skill preview <OWNER>/<REPOSITORY> <SKILL>",
      "gh skill install <OWNER>/<REPOSITORY> <SKILL> --agent <HOST> --scope <project|user>"
    ],
    "gotchas": [
      "Version: v2.90.0 or later",
      "Availability: Public preview; subject to change without notice.",
      "<QUERY> (required): Keyword to match against skill names or descriptions.",
      "<OWNER>/<REPOSITORY> (required): Repository containing the skill.",
      "<SKILL>: Skill name, namespaced name, or exact repository path. Omit to browse/select interactively; in non-interactive use, omit only with `--all`.",
      "--agent <HOST>: Target host. Current docs list `github-copilot`, `claude-code`, `cursor`, `codex`, `gemini-cli`, `antigravity`, and others.",
      "--scope <project|user>: Installation scope; defaults to `project`. Allowed values are `project` and `user`.",
      "Prerequisite: The manual labels skill commands as preview features, subject to change without notice.",
      "Prerequisite: The release note says GitHub CLI v2.90.0 or later is required.",
      "Skills are not verified by GitHub and may contain prompt injections, hidden instructions, or malicious scripts; inspect contents before installation.",
      "Docs conflict: Current manual lists `gemini-cli` as the `--agent` value; the release note’s example uses `gemini`. Do not treat those values as interchangeable without version-specific documentation."
    ]
  },
  "why_it_matters": "Install a repository skill for the agent host used by the coding workflow.",
  "sources": [
    "https://github.blog/changelog/2026-04-16-manage-agent-skills-with-github-cli",
    "https://cli.github.com/manual/gh_skill_search",
    "https://cli.github.com/manual/gh_skill_preview",
    "https://cli.github.com/manual/gh_skill_install",
    "https://cli.github.com/manual/gh_skill"
  ],
  "rank": 0.95049,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "recover-20261008",
    "verdict_id": "recover-20261008:recover-20261008-40ae979006020174-0:gate",
    "evidence_hash": "658f36545aa7a026ea230a624f14d037f1102ef31afed115129619817cb74470"
  },
  "review": {
    "draft_hash": "9877455f0b4c05c2c5706450cb62f6060708ede3a414599223199b73dcc1f8a1",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "recover-20261008:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.95 >= 0.9; 2 needed) and Jev gave 0.62 (>= 0.6 needed)."
  }
}