glab-variable — скилл для Claude Code: переменные GitLab CI/CD
Набор команд glab variable под рукой у агента: завести переменную пайплайна, поправить флаги, перенести секреты между проектами и группами GitLab.
MIT 126 установок ★ 51 обновлён 2026-10-20
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a claude-codeЧто делает glab-variable
Скилл описывает работу с glab variable: список, чтение, создание, правка, удаление, а ещё экспорт и импорт. По умолчанию команда бьёт по текущему проекту, --group переключает на группу, -R — на другой репозиторий.
get KEY --inherited ищет ключ сначала в проекте, потом в родительских группах от ближней к дальней, затем в переменных инстанса. Ответы 404/401/403 на уровне пропускаются, остальные ошибки возвращаются. update сохраняет флаги, которые вы не передали: --masked, --protected, --raw, --type, --description останутся прежними. Вызывать его с пустым stdin не стоит — значение затрётся пустой строкой.
import принимает тот же JSON, что отдаёт export --output json, из stdin или --input-file. Если ключ уже есть, импорт останавливается, пока не добавлен --skip-existing. Значения hidden-переменных в экспорт не попадают: такие записи пропускаются с предупреждением, их задают заново через glab variable set --hidden. Сам файл выгрузки — это секреты в открытом виде, поэтому держите его вне git.
Какие задачи решает
- прописать переменные пайплайна в проекте GitLab
- перенести набор CI/CD-переменных из одной группы в другую
- посмотреть, какое значение получает ключ с учётом родительских групп
- сменить описание или masked-флаг, не трогая само значение
- вычистить устаревший ключ из настроек проекта
Примеры запросов агенту
- Добавь в группу
platform/stagingпеременнуюDEPLOY_TOKEN, сделай её masked и protected. - Выгрузи переменные группы
platformв JSON и залей их вplatform/staging. - Покажи, откуда берётся
API_URL: проверь проект, а потом родительские группы.
Как установить glab-variable
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a claude-code2Вручную: положить файлы
~/.claude/skills/glab-variable/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/glab-variable/
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a codex2Вручную: положить файлы
.agents/skills/glab-variable/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a cursor2Вручную: положить файлы
.cursor/skills/glab-variable/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vince-winkintel/gitlab-cli-skills glab-variable2Вручную: положить файлы
.github/skills/glab-variable/SKILL.md1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a gemini-cli2Командой платформы
gemini skills install https://github.com/vince-winkintel/gitlab-cli-skills --path glab-variableВручную: положить файлы
.devin/skills/glab-variable/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о glab-variable
Как установить glab-variable в Claude Code?
Выполните npx skills add vince-winkintel/gitlab-cli-skills --skill glab-variable -a claude-code. Файл скилла окажется по пути ~/.claude/skills/glab-variable/SKILL.md.
Что делает glab-variable?
Описывает для агента подкоманды glab variable: создать, обновить, прочитать, удалить, выгрузить и импортировать переменные CI/CD проекта или группы.
Почему импорт пропускает часть переменных?
Значения hidden-переменных не попадают в файл экспорта, поэтому такие записи пропускаются с предупреждением. Их нужно задать заново через glab variable set --hidden из проверенного источника секретов.
Исходный текст
SKILL.md · MIT
---
name: glab-variable
description: Manage CI/CD variables at project and group level including create, update, import, export, list, and delete operations. Use when setting environment variables for pipelines, managing secrets, migrating variables, or configuring CI/CD variables. Triggers on variable, CI variable, environment variable, secrets, variable import, CI/CD config.
---
# glab variable
## Inherited reads and partial updates
`variable get KEY --inherited` tries the selected project or group, then parent groups closest first, then instance variables. Missing or unreadable levels (404/401/403) are skipped; other failures are returned. `--scope` filters project/group variables, but not instance variables. This is a lookup of stored definitions, not a full simulation of every CI variable precedence rule. Both text and JSON output can expose secret values; send them only to an approved consumer.
`variable update` preserves optional attributes unless supplied. Omitted `--protected`, `--masked`, `--raw`, `--type`, and `--description` retain their existing values. Use an explicit boolean such as `--protected=false` only when that policy change is approved. The value is still supplied positionally, through `--value`, or from stdin; do not invoke this as a metadata-only update with empty stdin, which can replace the value with an empty string. `--scope` retains its existing targeting behavior.
## Overview
```
Variables store configuration and secrets used by CI/CD pipelines.
Each subcommand acts on the current project by default. Use
`--group` to manage a group's variables instead.
USAGE
glab variable [command] [--flags]
COMMANDS
delete <key> [--flags] Delete a variable for a project or group.
export [--flags] Export variables from a project or group.
get <key> [--flags] Get a variable for a project or group.
import [--flags] Import variables from a JSON file or standard input.
list [--flags] List variables for a project or group.
set <key> <value> [--flags] Create a new variable for a project or group.
update <key> <value> [--flags] Update an existing variable for a project or group.
FLAGS
-h --help Show help for this command.
-R --repo Select another repository. Can use either `OWNER/REPO` or `GROUP/NAMESPACE/REPO` format. Also accepts full URL or Git URL.
```
## Quick start
```bash
glab variable --help
```
## Export and import variables
`glab variable import` consumes the same JSON array shape emitted by `glab variable export --output json`. It reads standard input by default or a file passed with `--input-file` / `-i`.
```bash
# Preview and preserve an export before importing it elsewhere
glab variable export --output json > variables.json
glab variable import --input-file variables.json -R group/target-project
# Pipe between groups
glab variable export --group source-group |
glab variable import --group target-group
# Continue when target variables already exist
glab variable import --input-file variables.json --skip-existing
```
Import stops when a target variable already exists unless `--skip-existing` is set. Hidden variable values are omitted from exports, so those entries are skipped with a warning during import; recreate their values explicitly with `glab variable set --hidden` from an approved secret source. Treat export files as sensitive, keep them out of version control, and verify the target project or group before importing.
## Masked and hidden group variables
`glab variable set` now sends `--masked` and `--hidden` correctly for group-level variables. Use explicit flags, verify the target group, and never print the value during confirmation:
```bash
glab variable set DEPLOY_TOKEN "$DEPLOY_TOKEN" \
--group group/subgroup \
--masked \
--hidden \
--protected
# Inspect only approved metadata; the raw JSON includes the value
glab variable get DEPLOY_TOKEN --group group/subgroup --output json \
--jq '{key, protected, masked, hidden, environment_scope}'
```
Masking and hiding are server-enforced properties, not substitutes for least privilege or rotation. If GitLab rejects a value because it does not satisfy masking rules, do not weaken the setting silently; fix the value format or get explicit operator approval for a different policy.
## Subcommands
See [references/commands.md](references/commands.md) for full `--help` output.
© vince-winkintel · MIT · vince-winkintel/gitlab-cli-skills