# migrate-gitlab-flags

> Claude/Codex skill by [@unleash](https://omgskills.com/library/unleash/index.md) · 1 stars · Updated 2026-08-03

Migrates a codebase from GitLab Feature Flags (the Unleash-compatible legacy API authenticated with UNLEASH-INSTANCEID) to a modern Unleash v8 server. Inventories flags and strategies, maps GitLab constructs to Unleash equivalents, provisions flags via multiple mechanisms (Unleash MCP server, import files, or direct Admin API), rewrites SDK configuration with minimal code changes, and verifies behavior parity. Use when asked to migrate off GitLab feature flags, move flags to Unleash, or port GitLab flag definitions to an Unleash server.

Tags: agent-skills, claude, claude-code, claude-code-plugin, claude-skills, feature-flags, featureops, mcp, unleash

## Install

```sh
git clone https://github.com/Unleash/unleash-claude-skills /tmp/unleash-claude-skills && ln -s /tmp/unleash-claude-skills/skills/migrate-gitlab-flags ~/.claude/skills/migrate-gitlab-flags
```

## From README

Migrate GitLab Feature Flags to Unleash (v8+) Migrate one app or service off GitLab's Unleash-compatible legacy flag API onto a real Unleash v8 server: recreate the flag definitions, rewrite the SDK wiring, and prove behavior parity. There is no automated import/export mechanism from GitLab to Unleash, therefore recreating definitions is always part of the job. Non-negotiable invariants State carries over exactly. A flag enabled in GitLab is enabled in Unleash; a disabled flag arrives disabled (per environment). Always — never ship flags "off for safety" or "on for convenience". Flag names are unchanged (the only exception: a collision prefix agreed with the user when sharing an OSS default project — see Inputs step 3). Minimal code diff. Mirror the existing patterns; the migration is not a refactoring opportunity (see Phase 5). Least-privilege credentials.

## Links

- HTML page: https://omgskills.com/library/unleash/unleash-claude-skills/skills/migrate-gitlab-flags/
- GitHub: https://github.com/Unleash/unleash-claude-skills
- Author: [@unleash](https://omgskills.com/library/unleash/index.md)

## More from this repo

- [featureops](https://omgskills.com/library/unleash/unleash-claude-skills/skills/featureops/index.md) — Used to manage feature flags with Unleash — evaluate whether a code change needs a flag, create flags with consistent...
   - [@unleash](https://omgskills.com/library/unleash/index.md) · 1 stars
