Skip to content

metalbear-co/mirrord / skills/skills/mirrord-ci

mirrord-ci

Flagged

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.

FileKindSize
README.mdmarkdown1.7 KB
SKILL.mdskill md14.7 KB
references/troubleshooting.mdmarkdown9.2 KB
# mirrord-ci

Set up mirrord in CI pipelines for testing against real Kubernetes environments.

## What it does

This skill helps AI agents:
- **Configure** CI runners to connect to Kubernetes clusters
- **Generate** CI workflow files (GitHub Actions, GitLab CI, CircleCI, Jenkins)
- **Set up** `mirrord ci start/stop` commands properly
- **Troubleshoot** CI-specific mirrord issues

## Example prompts

```
"Set up mirrord for GitHub Actions"

"How do I run integration tests against staging in CI?"

"Generate a GitLab CI config that uses mirrord"

"mirrord ci start is not working in my pipeline"
```

## How it works

1. Asks about your CI platform and target environment
2. Verifies prerequisites (mirrord version, kubectl access)
3. Generates platform-specific CI configuration
4. Includes proper setup and cleanup steps
5. Provides troubleshooting guidance

## Key commands

```bash
# Start app with mirrord in background
mirrord ci start --target deployment/my-app -- npm start

# Run your tests
npm test

# Stop all mirrord sessions
mirrord ci stop
```

## Supported CI platforms

- GitHub Actions
- GitLab CI
- CircleCI
- Jenkins
- Any CI platform with shell access

## References

This skill uses local reference files:
- [`../mirrord-config/references/schema.json`](../mirrord-config/references/schema.json) - mirrord JSON Schema, synced from upstream. The fence tag check validates config examples against it; read it only as a last resort, when neither `validate_config` (mirrord MCP server) nor `mirrord verify-config` is available
- `references/troubleshooting.md` - Common issues and solutions

## Learn more

- [mirrord for CI Overview](https://metalbear.com/mirrord-for-ci/)
- [mirrord CI Documentation](https://mirrord.dev/docs/using-mirrord/mirrord-for-ci/)
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 323kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 323kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 323kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall