# Mirrord Ci

Help users set up mirrord in CI pipelines for testing against real Kubernetes...

- Repository: https://github.com/metalbear-co/mirrord (5397 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add metalbear-co/mirrord --skill mirrord-ci -g -a claude-code -y`
Codex: `npx skills add metalbear-co/mirrord --skill mirrord-ci -g -a codex -y`
Cursor: `npx skills add metalbear-co/mirrord --skill mirrord-ci -g -a cursor -y`
Gemini CLI: `npx skills add metalbear-co/mirrord --skill mirrord-ci -g -a gemini-cli -y`

## Description

Help users set up mirrord in CI pipelines for testing against real Kubernetes environments. Use when users want to run end-to-end tests, integration tests, or automated tests in CI using mirrord to connect to staging/shared clusters.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Mirrord CI Skill

## Purpose

Help users integrate mirrord into CI pipelines for testing against real Kubernetes environments:
- **Configure** CI runners to connect to Kubernetes clusters
- **Set up** `mirrord ci start/stop` commands in CI workflows
- **Generate** CI workflow files for GitHub Actions, GitLab CI, etc.
- **Troubleshoot** CI-specific mirrord issues

## When to Use This Skill

Trigger on questions like:
- "How do I use mirrord in CI?"
- "Set up mirrord for GitHub Actions"
- "Run tests against staging in CI"
- "mirrord ci start not working"
- "Configure mirrord for GitLab CI"

## Security note for CI examples

- **Do not** use remote pipe-to-shell installs or other unverified script execution in CI to install mirrord.
- Pre-install mirrord in a **trusted CI image**, use your org’s **approved** package manager with pinned versions, or follow [official install docs](https://mirrord.dev/docs/overview/quick-start/). The YAML below assumes `mirrord` is already available on the runner unless you add an approved install step.

## Critical First Steps

**Step 1: Load references**
Read the reference file from this skill's `references/` directory:
- `references/troubleshooting.md` - Common issues and solutions

The troubleshooting guide helps diagnose and fix common mirrord issues.
To look up a config option, call `explain_config_option` if the mirrord MCP server is connected; otherwise use `references/configuration.md` in the mirrord-config skill.

If using absolute paths, search for them using patterns like `**/mirrord-ci/references/*`.

The rest: https://github.com/metalbear-co/mirrord/blob/HEAD/mirrord/mcp/corpus/skills/mirrord-ci/SKILL.md