> For the complete documentation index, see [llms.txt](https://metalbear.com/mirrord/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://metalbear.com/mirrord/docs/use-cases/using-mirrord-with-ai/ai-skills-plugin.md). # Agent Skills for mirrord Install the mirrord skills plugin to give AI coding assistants like Cursor and Claude Code domain-specific knowledge of how to work with mirrord. MetalBear maintains a **mirrord skills plugin** that extends AI coding assistants, such as Cursor and Claude Code with domain-specific knowledge about mirrord. Instead of relying solely on general instructions in `AGENTS.md`, these skills give your AI assistant built-in expertise for mirrord configuration, troubleshooting, and best practices. {% embed url="" %} **See the mirrord agent skills plugin in action** ### What Are mirrord Skills? Skills are reusable instruction modules that teach AI agents how to work with mirrord. When you install the mirrord skills plugin, your AI assistant can: * Generate and validate `mirrord.json` configuration files * Guide you through installation and your first mirrord session * Help set up mirrord in CI pipelines * Configure the mirrord operator for team environments * Help set up [database branching](/mirrord/docs/sharing-the-cluster/db-branching.md) for your cluster * Configure [queue splitting](/mirrord/docs/sharing-the-cluster/queue-splitting.md) for Kafka topics * Make your services [propagate the baggage header](/mirrord/docs/use-cases/preview-environments/preview-environments-in-ci.md#header-propagation-for-backend-testing) across HTTP, gRPC, and queues, so filters, preview environments, and queue splitting follow a request end to end, and get a report of every hop where the header is still dropped * Create [preview environments](/mirrord/docs/use-cases/preview-environments.md), ad hoc or per-PR in CI * [Chaos test](/mirrord/docs/use-cases/chaos-testing.md) your app with per-session latency and connection-error rules ### Available Skills For the full list of skills, what each one covers, and example prompts, see [mirrord Agent Skills](https://github.com/metalbear-co/skills/#mirrord-agent-skills) in the [metalbear-co/skills](https://github.com/metalbear-co/skills/) repository. ### Installing the mirrord Skills The mirrord skills are distributed as a plugin that you install into your AI coding assistant. Installation steps depend on your tool. Check the [mirrord skills repository](https://github.com/metalbear-co/skills/) for the latest installation instructions... ### Agents That Don't Support Agent Skills GitHub Copilot and Cline read repository rules files instead of Agent Skills. The skills repository ships drop-in equivalents carrying the same core content in its [ports directory](https://github.com/metalbear-co/skills/tree/main/ports): copy `ports/github-copilot/copilot-instructions.md` into your repository's `.github/` folder, or `ports/cline/.clinerules` into the repository root. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://metalbear.com/mirrord/docs/use-cases/using-mirrord-with-ai/ai-skills-plugin.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.