{
  "slug": "gh-skill-manages-and-publishes-agent-skills-70f71668c6ab",
  "title": "gh skill manages and publishes agent skills",
  "tools": [
    "gh"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-04-16T18:19:28.000Z",
  "announced_at": "2026-04-16T18:19:28.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When managing a skill from a GitHub repository, use `gh skill` to search, preview, install, or update it; to validate or publish your own skills, run `gh skill publish` from the local repository. Installation can target an agent and project or user scope.",
    "examples": [
      "gh skill install <owner>/<repo> <skill> --agent <agent> --scope <project|user>",
      "gh skill update --all",
      "gh skill publish --dry-run"
    ],
    "gotchas": [
      "Version: v2.90.0",
      "Availability: Public Preview; subject to change without notice.",
      "<owner>/<repo> (required): GitHub repository containing the skill.",
      "<skill>: Skill name, namespaced name, or repository path; required for a specific skill unless using `--all`.",
      "--agent <agent>: Select the target agent; install documentation gives supported values.",
      "--scope <project|user>: Choose installation scope; default is `project`.",
      "--pin <tag-or-SHA>: Pin installation to a Git tag or commit SHA.",
      "--all: Update all installed skills without prompting.",
      "--dry-run: Validate publishing without publishing.",
      "Prerequisite: Install command requires a GitHub repository in `OWNER/REPO` format; skills are discovered from `SKILL.md` files.",
      "Prerequisite: Publishing validates skills in a local repository and creates a GitHub release after validation.",
      "Prerequisite: The release identifies `gh skill` as public preview in GitHub CLI v2.90.0.",
      "Skills are automatically installed to the correct directory for the agent host.",
      "Supported hosts are GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, and Antigravity.",
      "Docs conflict: The current install manual lists additional agent hosts beyond the six named in the v2.90.0 release note; the manual reflects a newer, broader host list.",
      "Docs conflict: The current publish manual describes release creation but does not document the release note's auto-push of unpushed commits."
    ]
  },
  "why_it_matters": "Manage or publish an agent skill from a GitHub repository for a supported coding agent host.",
  "sources": [
    "https://github.com/cli/cli/releases/tag/v2.90.0",
    "https://cli.github.com/manual/gh_skill_install",
    "https://cli.github.com/manual/gh_skill_update",
    "https://cli.github.com/manual/gh_skill_publish"
  ],
  "rank": 0.97036,
  "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": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-a73ae56d62f5f57f-0:gate",
    "evidence_hash": "3878bed34d50b7c070e25270e11d73817824afe5bbed911d709c96f115ef78cc"
  },
  "review": {
    "draft_hash": "78fec107cae69815de431275e57a87acdd1436bf911e1b127d24c423bdcf9a9f",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.65 (>= 0.6 needed)."
  }
}