glab-skills

glab skills

概述

此处的帮助信息摘自经过校验和验证的 macOS arm64 发布二进制文件。已移除终端填充字符和尾随空格；发布来源记录在 VERSION 中。

  Install the bundled glab agent skills so that AI agents can discover
  and use glab effectively.

  Skills follow the Agent Skills specification and work with
  any compatible agent, including GitLab Duo Agent Platform, Claude Code, Codex,
  and Gemini CLI.

  This feature is an experiment and is not ready for production use.
  It might be unstable or removed at any time.
  For more information, see
  https://docs.gitlab.com/policy/development_stages_support/.


  USAGE

    glab skills <command> [command] [--flags]

  COMMANDS

    get <name> [<path>]       Print a bundled agent skill file. (EXPERIMENTAL)
    install [name] [--flags]  Install glab's bundled agent skills. (EXPERIMENTAL)
    list                      List the available bundled agent skills. (EXPERIMENTAL)
    update [name] [--flags]   Update installed agent skills to the current shipped version. (EXPERIMENTAL)

  FLAGS

    -h --help                 Show help for this command.

⚠️ 实验性功能

上游将 glab skills 标记为实验性功能：

• 命令形式和功能可能会变更
• 技能包格式尚未稳定
• 是否可用可能因 glab 版本而异
• 适用于探索和原型设计，不适用于生产工作流

参见：https://docs.gitlab.com/policy/development_stages_support/

快速开始

# View available skills commands
glab skills --help

# Inspect a bundled skill without installing it
glab skills get glab

# Install bundled agent skills
glab skills install

# List bundled skills
glab skills list

# Update the installed core skill to the current glab-shipped version
glab skills update glab

常见工作流

检查、安装、列出和更新捆绑技能

# Print the bundled skill manifest without installing it
glab skills get glab

# Print a supporting file relative to a bundled skill root
glab skills get <name> references/<file>.md

# Install agent skills interactively
glab skills install

# Install a named bundled skill when supported by the shipped catalog
glab skills install <name>

# List available bundled skills
glab skills list

# Update all installed skills, including curated remote skills
glab skills update --all

# Update one installed skill (bundled or curated remote)
glab skills update <name>

get 会将请求的捆绑文件写入标准输出，默认为 SKILL.md；它不会安装技能。install 命令会为自动化和 AI Agent 工作流设置技能包。使用 glab skills update <name> 或 glab skills update --all 可从来源更新已安装的技能。名称和 --all 不能同时使用，且必须指定其中一项。

glab 还会在已安装的捆绑技能与当前二进制文件附带的版本不同时发出通知。运行更新检查时，它也可以通知你精选远程技能的更新；这些检查会按照更新检查的周期从 GitLab.com 获取信息，而不是在每次运行命令时检查。通知尽力而为，可通过 notify_skill_updates 或 GLAB_NOTIFY_SKILL_UPDATES 禁用。通知不会自动更新文件：请先检查内容，并在需要时使用 glab skills update <name> 或 glab skills update --all。

精选远程 Orbit 技能

# Review the catalog before selecting a skill
glab skills list

# Install the remote Orbit wrapper skill into the current project
glab skills install orbit

# Alternatively, choose user scope or a custom parent directory
glab skills install orbit --global
glab skills install orbit --path ./reviewed-skills

# Refresh an installed copy in a standard project/user location
glab skills update orbit

glab skills list 会读取捆绑目录和内嵌的远程注册表，不会发起网络请求。orbit 注册表条目会从 GitLab.com 上的公开项目 gitlab-org/orbit/knowledge-graph 获取完整的 skills/orbit-wrapper 目录树，无需身份验证。其 latest 引用表示项目的默认分支，而非最新发布标签。安装程序会将上游 frontmatter 中的名称改写为 orbit，以匹配安装目录。在允许 Agent 使用之前，请检查远程内容；它可能会独立于已安装的 glab 二进制文件发生变化。

默认目标位置是当前 Git 仓库根目录下的 .agents/skills/orbit/；--global 使用 ~/.agents/skills/orbit/，而 --path 会相对于当前工作目录解析。安装时若要覆盖现有技能文件，必须使用 --force。glab skills update orbit 会重新获取标准位置中的技能并覆盖已更改的内容，而 --all 会更新这些位置中所有已安装的技能。更新不会发现自定义 --path 位置；如有需要，请先检查自定义路径，再使用 --force 明确重新安装。

尽管帮助文本仍写着“bundled”，list、指定名称的 install 和 update 也适用于精选远程技能。不指定名称的 glab skills install 只会安装捆绑的核心 glab 技能。glab skills get orbit 无法打印此远程技能：get 仅适用于捆绑技能。安装远程技能既不会下载也不会运行 Orbit 可执行文件；受管二进制文件的安装是单独的 glab orbit --install 操作。

故障排除

skills: command not found：

• glab skills 用于管理 CLI 技能和扩展。
• 使用 glab version 检查版本；如有需要，请升级。

技能安装/更新失败或卡住：

• 这是一项实验性功能，可能还不够完善。
• 对于捆绑技能，请检查目标位置权限和已安装的目录；安装不需要网络连接或 glab 身份验证。
• 对于 orbit 等精选远程技能，请检查与公共 gitlab.com 和 gitlab-org/orbit/knowledge-graph 项目的连接，以及目标位置权限。这些下载无需身份验证；仅自托管或隔离网络环境中的主机仍需能够访问 GitLab.com。
• 查看 glab skills get --help、glab skills install --help、glab skills list 和 glab skills update --help，了解是否有更新的标志或要求。

有哪些技能可用？

• 运行 glab skills list，查看已安装 glab 版本对应的捆绑目录和精选远程目录。

相关技能

• glab-duo — GitLab Duo AI 助手集成
• glab-mcp — 已弃用的 glab MCP 兼容功能；如需新的集成，请使用 GitLab MCP Server
• glab-orbit — 托管的 Orbit 二进制文件和图谱工作流
• glab-auth — GitLab 操作的身份验证；精选公共远程技能下载不会使用它

命令参考

skills get

来自已验证发布二进制文件的完整帮助信息；不可变捕获 ID 5686d7484 对应 VERSION 中的发布版本和归档校验和。仅移除尾随空格；保留缩进、空行、换行、截断内容和产品拼写。

  Print a file from an agent skill bundled with this glab binary without installing it.

  The path is relative to the skill root and defaults to `SKILL.md`.

  This feature is an experiment and is not ready for production use.
  It might be unstable or removed at any time.
  For more information, see
  https://docs.gitlab.com/policy/development_stages_support/.


  USAGE

    glab skills get <name> [<path>] [--flags]

  EXAMPLES

    # Print the manifest for the bundled glab skill
    glab skills get glab

    # Print the other bundled skill
    glab skills get glab-stack

    # For skills that ship supporting files, use the path form
    # glab skills get <name> references/<file>.md

  FLAGS

    -h --help  Show help for this command.

skills install

来自已验证发布二进制文件的完整帮助信息；不可变捕获 ID 5686d7484 对应 VERSION 中的发布版本和归档校验和。仅移除尾随空格；保留缩进、空行、换行、截断内容和产品拼写。

  Install bundled `SKILL.md` files to `.agents/skills/`, the
  cross-agent standard defined by the Agent Skills specification. This works
  with GitLab Duo Agent Platform, Claude Code, Codex, Gemini CLI, and any
  other compliant agent.

  By default, only the core `glab` skill is installed. Pass a positional
  `name` argument to install a specific bundled skill instead. Run
  `glab skills list` to see what is available.

  Install scope:

  - By default, skills are installed for the current project, in `.agents/skills/`
    at the root of the current Git repository.
  - Use `--global` to install skills for the current user, in
    `~/.agents/skills/`.
  - Use `--path` to install skills to a custom directory. The path is resolved
    relative to the current working directory, not the repository root.

  To overwrite an existing skill file, use `--force`.

  This feature is an experiment and is not ready for production use.
  It might be unstable or removed at any time.
  For more information, see
  https://docs.gitlab.com/policy/development_stages_support/.


  USAGE

    glab skills install [name] [--flags]

  EXAMPLES

    # Install the core glab skill in the current project (default)
    glab skills install

    # Install a specific bundled skill by name
    glab skills install glab-stack

    # Install the core skill globally (user scope)
    glab skills install --global

    # Install a skill to a custom directory
    glab skills install glab-stack --path /path/to/skills

    # Overwrite an existing skill file
    glab skills install --force

  FLAGS

    -f --force   Overwrite existing skill files.
    -g --global  Install skills at user scope (~/.agents/skills/).
    -h --help    Show help for this command.
    --path       Install skills to the directory at <path>.

skills list

来自已验证发布二进制文件的完整帮助信息；不可变捕获 ID 5686d7484 对应 VERSION 中的发布版本和归档校验和。仅移除尾随空格；保留缩进、空行、换行、截断内容和产品拼写。

  List the agent skills bundled with glab. Use the name of a skill with
  'glab skills install <name>' to install just that one.

  This feature is an experiment and is not ready for production use.
  It might be unstable or removed at any time.
  For more information, see
  https://docs.gitlab.com/policy/development_stages_support/.


  USAGE

    glab skills list [--flags]

  EXAMPLES

    # List every bundled skill with its description
    glab skills list

  FLAGS

    -h --help  Show help for this command.

skills update

来自已验证发布二进制文件的完整帮助信息；不可变捕获 ID 5686d7484 对应 VERSION 中的发布版本和归档校验和。仅移除尾随空格；保留缩进、空行、换行、截断内容和产品拼写。

  Re-fetch installed agent skills from their source (bundled in this
  glab binary, or the curated remote registry) and overwrite the on-disk
  copy if it differs.

  By default, updates only the named skill in every well-known location
  it is installed (the current project's '.agents/skills/' and the
  user-scope '~/.agents/skills/'). Use --all to update every installed
  skill in those locations.

  Skills whose on-disk content already matches the source are left alone.
  Skills installed via 'glab skills install --path' are not considered —
  update only knows about the two well-known locations.

  This feature is an experiment and is not ready for production use.
  It might be unstable or removed at any time.
  For more information, see
  https://docs.gitlab.com/policy/development_stages_support/.


  USAGE

    glab skills update [name] [--flags]

  EXAMPLES

    # Update the bundled glab skill in every location it is installed
    glab skills update glab

    # Update every installed skill
    glab skills update --all

  FLAGS

    --all      Update every installed skill.
    -h --help  Show help for this command.