Agent skill

Mirrord Quickstart

by metalbear-co in metalbear-co/mirrord

Guide users from zero to their first working mirrord session.

MITAuto-check passedDevOps & Cloud

Install Mirrord Quickstart

skills CLI
$ npx skills add metalbear-co/mirrord --skill mirrord-quickstart -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install metalbear-co/mirrord mirrord-quickstart --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/metalbear-co/mirrord.git skills-src && mkdir -p .claude/skills && cp -r skills-src/mirrord/mcp/corpus/skills/mirrord-quickstart .claude/skills/mirrord-quickstart && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mirrord-quickstart
GitHub stars
5.4k
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
572 words
Files
2
Repo updated
First seen
Licence
MIT

At a glance

Guide users from zero to their first working mirrord session.

  • Works in 4 steps: Open VS Code Extensions (Cmd/Ctrl+Shift+X) → Search "mirrord" → Install "mirrord" by MetalBear → …
  • A user is new to mirrord
  • SKILL.md covers Purpose, Critical First Steps, Installation Paths and First Session, plus 5 more sections
  • Calls kubectl

What it does

Mirrord Quickstart is an agent skill from metalbear-co/mirrord. Guide users from zero to their first working mirrord session. Use when a user is new to mirrord, wants to install it, or needs help running their first session connecting to a Kubernetes cluster.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in DevOps & Cloud, covering Container orchestration. It works with Kubernetes, Visual Studio Code and JetBrains IDEs. The repository describes itself as: Run any process, on your machine or in an AI agent's environment, as if it were a pod in your Kubernetes cluster: real env vars, DNS, network, traffic. The licence is MIT.

When your agent uses it

  • A user is new to mirrord
  • Wants to install it
  • Needs help running their first session connecting to a Kubernetes cluster

Example prompts

  • “/mirrord-quickstart”

Requirements

  • Python 3
  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Open VS Code Extensions (Cmd/Ctrl+Shift+X)
  2. Search "mirrord"
  3. Install "mirrord" by MetalBear
  4. Look for mirrord icon in status bar

What it can do on your machine

Read from SKILL.md and the folder at commit c8f017a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • kubectl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • metalbear.com
    • mirrord.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mirrord Quickstart loads about 1.3k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 572 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from metalbear-co/mirrord at commit c8f017a, republished under its MIT licence (© metalbear-co). 572 words, ~1,299 tokens.

Download SKILL.mdSave it as .claude/skills/mirrord-quickstart/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
mirrord-quickstart
description
Guide users from zero to their first working mirrord session. Use when a user is new to mirrord, wants to install it, or needs help running their first session connecting to a Kubernetes cluster.
metadata.author
MetalBear
metadata.version
1.2

Mirrord Quickstart Skill

Purpose

Help new users get mirrord running quickly:

  • Check system requirements
  • Install mirrord (CLI, VS Code, or IntelliJ)
  • Connect to their first Kubernetes target
  • Verify the connection works

Critical First Steps

Step 1: Detect user's environment Ask or detect:

  • Operating system (macOS, Linux, Windows)
  • Preferred workflow (CLI, VS Code, IntelliJ)
  • Do they have kubectl configured?

Step 2: Verify requirements

bash
# Check kubectl access
kubectl cluster-info
kubectl get pods -A | head -5

If kubectl fails, help them configure it first.

Installation Paths

Do not run remote install scripts that pipe a network download into a shell interpreter. Use only methods your organization approves.

Official guide: Follow mirrord installation documentation for supported options (package managers, pinned release binaries with checksum verification, etc.).

Summary for the agent:

  • macOS / Linux: Point the user to the official docs for Homebrew, apt, or pinned binary install steps — do not invent or paste one-liners that fetch and execute remote scripts.
  • Windows: Point the user to the official docs for supported installers.

Security: Prefer package managers or manually verified binaries from official release artifacts. Never execute installation by piping downloaded content into a shell.

Verify installation:

bash
mirrord --version
VS Code Extension
  1. Open VS Code Extensions (Cmd/Ctrl+Shift+X)
  2. Search "mirrord"
  3. Install "mirrord" by MetalBear
  4. Look for mirrord icon in status bar
IntelliJ Plugin
  1. Open Settings → Plugins → Marketplace
  2. Search "mirrord"
  3. Install and restart IDE
  4. Find mirrord in navigation toolbar

First Session

CLI approach
bash
# List available targets
mirrord ls

# Run a local process with mirrord
mirrord exec --target pod/<pod-name> -- <your-command>

# Example: Node.js app
mirrord exec --target pod/api-server-7c8d9 -- node app.js

# Example: Python app
mirrord exec --target pod/backend-abc123 -- python main.py
IDE approach
  1. Enable mirrord (click status bar icon / toolbar button)
  2. Select target pod when prompted
  3. Run/debug your application normally
  4. mirrord intercepts and connects automatically

Verification

After running, verify the connection:

  1. Check logs - You should see mirrord initialization messages
  2. Test environment - Remote env vars should be available locally
  3. Test network - Make a request to your remote service; it should reach your local process
bash
# Quick test: print remote env vars
mirrord exec --target pod/<pod-name> -- env | grep -i database
Show full SKILL.md (269 more words)Show less

What's Next

Once the first session works, point users to:

  • mirrord ui — launches a local dashboard showing every active session on the machine, with a live event stream (HTTP requests, file operations, DNS, outgoing connections). See Local UI.
  • mirrord up — for debugging several microservices together from one mirrord-up.yaml (compose-style). Point to the mirrord-up skill.
  • Browser extension — routes requests made from Chrome to the local process, for testing an HTTP-filtered session from a browser instead of curl. See Debugging from Browser.
  • mirrord for Teams features (DB branching, queue splitting, preview environments, concurrent steal on one target) need the Operator. On a cluster with no license, an AI agent can offer the user a seven-day Enterprise trial and start it once they agree: point to the mirrord-operator skill, "Agent-started trial".

Common First-Timer Issues

IssueSolution
"kubectl not found"Install kubectl and configure cluster access
"No pods found"Check namespace: kubectl get pods -n <namespace>
"Permission denied"Check RBAC permissions for your kubectl context
"Agent failed to start"Ensure cluster runs Linux kernel 4.20+

Response Guidelines

  1. Ask about their setup - OS, IDE preference, existing kubectl access
  2. Go step by step - Don't overwhelm with all options at once
  3. Verify each step - Confirm installation worked before moving on
  4. Celebrate success - When they connect, explain what just happened

Example Interaction

User: "I want to try mirrord"

Response:

  1. Ask: macOS/Linux/Windows? CLI or IDE?
  2. Check: kubectl cluster-info working?
  3. Install: Follow the official quick-start for their OS (no remote pipe-to-shell installs)
  4. Run: mirrord ls to see targets
  5. Connect: mirrord exec --target pod/X -- <their-app>
  6. Verify: Show them it's working

© metalbear-co, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in mirrord/mcp/corpus/skills/mirrord-quickstart of metalbear-co/mirrord.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit c8f017a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in metalbear-co/mirrord, which our catalogue first saw on October 11, 2026.

Compare with similar skills

Mirrord Quickstart next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mirrord Quickstart compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mirrord Quickstart this skillmetalbear-co/mirrord5.4k1 repos~1.3kAutomated safety check: PassMIT
Sim Helmsimstudioai/sim30k—~2.2kAutomated safety check: PassApache-2.0
Helm Chart ScaffoldingCybereason-Public/owLSM28013 repos~381Automated safety check: PassGPL-2.0
Kubeshark KFL2 Filter Referencekubeshark/kubeshark12k—~3.6kAutomated safety check: PassApache-2.0
Nginx To Higress Migrationhigress-group/higress9.5k—~3.9kAutomated safety check: PassApache-2.0
LangBot Deployment Guidelangbot-app/LangBot18k—~1.5kAutomated safety check: NotesApache-2.0

Similar skills

  • Sim Helm

    simstudioai/sim

    Install, upgrade, and operate the Sim Helm chart on Kubernetes.

    30k GitHub stars~2.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Helm Chart Scaffolding

    Cybereason-Public/owLSM

    Comprehensive guidance for creating, organizing, and managing Helm charts for packaging and deploying Kubernetes applications.

    280 GitHub starsUsed in 13 repos~381 tokens
    DevOps & CloudAuto-check passed
  • Syntax reference for KFL2, the CEL-based display filter language used to search Kubernetes network traffic captured by Kubeshark, loaded before any filter is written.

    12k GitHub stars~3.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Nginx To Higress Migration

    higress-group/higress

    Migrate from ingress-nginx to Higress in Kubernetes environments.

    9.5k GitHub stars~3.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Official

    Maintain and validate OpenShell's build-only Windows MSVC lane for x64 and ARM64.

    16k GitHub stars~4.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from metalbear-co/mirrord

All 10 skills in this repo
  • Mirrord Operator

    metalbear-co/mirrord

    Help users install and configure the mirrord Operator for team/enterprise environments.

    5.4k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Mirrord Temporal

    metalbear-co/mirrord

    Helps DevOps engineers configure mirrord Operator's Temporal task queue splitting feature end-to-end.

    5.4k GitHub starsUsed in 1 repo~5.1k tokens
    Auto-check passed
  • Mirrord CI

    metalbear-co/mirrord

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

    5.4k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check: warnings
  • Mirrord Chaos

    metalbear-co/mirrord

    Help users chaos test their app with mirrord: inject artificial latency or connection errors into a mirrord session's outgoing traffic via per-session chaos rules managed with the mirrord chaos CLI.

    5.4k GitHub starsUsed in 1 repo~3.4k tokens
    Auto-check passed
  • Mirrord Config

    metalbear-co/mirrord

    Helps users generate, edit, and validate mirrord.json configuration files for mirrord (MetalBear).

    5.4k GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed
  • Mirrord Kafka

    metalbear-co/mirrord

    Helps DevOps engineers configure mirrord Operator's Kafka queue splitting feature end-to-end.

    5.4k GitHub starsUsed in 1 repo~6k tokens
    Auto-check passed

Categories

Questions about Mirrord Quickstart

What does Mirrord Quickstart do?

Guide users from zero to their first working mirrord session. Mirrord Quickstart is an agent skill from metalbear-co/mirrord. Guide users from zero to their first working mirrord session.

When should I use Mirrord Quickstart?

Mirrord Quickstart fits situations like: A user is new to mirrord; wants to install it; needs help running their first session connecting to a Kubernetes cluster.

How do I install Mirrord Quickstart in Claude Code?

Run `npx skills add metalbear-co/mirrord --skill mirrord-quickstart -a claude-code`. Or copy the skill folder (mirrord/mcp/corpus/skills/mirrord-quickstart in metalbear-co/mirrord) into .claude/skills/mirrord-quickstart in your project. Claude Code loads it when a task matches its description.

How do I install Mirrord Quickstart in Codex?

Run `npx skills add metalbear-co/mirrord --skill mirrord-quickstart -a codex`. Or copy the skill folder (mirrord/mcp/corpus/skills/mirrord-quickstart in metalbear-co/mirrord) into .agents/skills/mirrord-quickstart in your project. Codex loads it when a task matches its description.

Can I use Mirrord Quickstart in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add metalbear-co/mirrord --skill mirrord-quickstart -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mirrord-quickstart, .gemini/skills/mirrord-quickstart, .github/skills/mirrord-quickstart and .opencode/skills/mirrord-quickstart in your project.

What does Mirrord Quickstart need to run?

Going by SKILL.md and its folder, Mirrord Quickstart needs the command-line tools its instructions call (kubectl). Our summary lists: Python 3; Node.js.

Does Mirrord Quickstart access the network?

SKILL.md names 2 domains. As links in the text: metalbear.com and mirrord.dev. This is read from the text; nothing was executed.

Is Mirrord Quickstart safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mirrord Quickstart use?

Mirrord Quickstart is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mirrord Quickstart use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mirrord Quickstart?

Skills that share tags, products or a category with Mirrord Quickstart: Sim Helm (simstudioai/sim, 30k stars), Helm Chart Scaffolding (Cybereason-Public/owLSM, 280 stars), Kubeshark KFL2 Filter Reference (kubeshark/kubeshark, 12k stars) and Nginx To Higress Migration (higress-group/higress, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mirrord Quickstart?

metalbear-co (a GitHub organization) maintains it in metalbear-co/mirrord, which has 5,362 GitHub stars. The repository was last updated on October 11, 2026.

Source: metalbear-co/mirrord on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.