Skills and agents for managing your miren infrastructure. Supports multiple AI coding agents via the Agent Skills standard.

Installation

Claude Code

Add the marketplace and install the plugin:

/plugin marketplace add mirendev/miren-skills
/plugin install miren@miren

For local development:

claude --plugin-dir /path/to/miren-skills

Codex CLI

Install the skills globally:

mkdir -p ~/.agents/skills
cp -r /path/to/miren-skills/.agents/skills/* ~/.agents/skills/

Or add to a specific project:

mkdir -p .agents/skills
cp -r /path/to/miren-skills/.agents/skills/* .agents/skills/

Amp

Install via the command palette (Ctrl+O in CLI, Cmd+Shift+P in VS Code):

skill: add https://github.com/mirendev/miren-skills

Or copy skills into your project:

mkdir -p .agents/skills
cp -r /path/to/miren-skills/.agents/skills/* .agents/skills/

Pi

Install as a package:

pi install git:github.com/mirendev/miren-skills

Or copy skills into your project:

mkdir -p .pi/skills
cp -r /path/to/miren-skills/.agents/skills/* .pi/skills/

OpenCode

Copy skills into your project:

mkdir -p .opencode/skills
cp -r /path/to/miren-skills/.agents/skills/* .opencode/skills/

Or install globally:

mkdir -p ~/.config/opencode/skills
cp -r /path/to/miren-skills/.agents/skills/* ~/.config/opencode/skills/

What's included

Skills

use-miren

The core skill for operating miren. Automatically invoked when you mention miren or ask about miren workflows. It:

• Discovers commands via miren help
• Supports -C <cluster> targeting (e.g., "how's the garden cluster doing")
• Prefers --json output for reliable parsing

Agents

cluster-health

Surveys all apps and services across a miren cluster and produces a structured health report. Invoke by asking things like:

• "How's the cluster looking?"
• "Give me a health check on garden" (uses -C garden)
• "What's the status of all my apps?"

Reports include: cluster overview, app-by-app breakdown, sandbox status, diagnostics summary, and prioritized recommendations.

app-setup

Analyzes application source code to discover requirements and walks you through setting up the app on Miren. It detects your stack, environment variables, databases, and external services, then interactively guides you through miren init, .miren/app.toml generation, and env var configuration. Invoke by asking:

• "Help me set up this app on miren"
• "What does this app need to run?"
• "I want to onboard this project to miren"

Covers: stack detection, env var discovery, database setup (using /miren/data/local), service definitions, build config, and post-import commands.

app-health

Deep inspection of a single miren app. Defaults to the app miren resolves from your current directory. Invoke by asking:

• "How's this app doing?"
• "Check the health of myapp"
• "What's wrong with myapp on garden?"

Reports include: app status, service states, deployment history, log analysis, diagnostics, and recommendations.

Directory Structure

.agents/skills/                    # Agent Skills standard (Codex, Amp, Pi, OpenCode)
  use-miren/SKILL.md              #   -> symlink to plugins/miren/skills/use-miren/SKILL.md
  app-setup/SKILL.md              #   -> symlink to plugins/miren/agents/app-setup.md
  app-health/SKILL.md             #   -> symlink to plugins/miren/agents/app-health.md
  cluster-health/SKILL.md         #   -> symlink to plugins/miren/agents/cluster-health.md
.claude-plugin/marketplace.json    # Claude Code marketplace
.codex-plugin/plugin.json          # Codex CLI plugin manifest
AGENTS.md                          # Instructions for Codex/Amp/OpenCode
plugins/miren/                     # Claude Code plugin source
  .claude-plugin/plugin.json
  skills/use-miren/SKILL.md
  agents/{app-setup,app-health,cluster-health}.md

Commands reference

The plugin teaches Claude to use miren help for self-discovery:

miren help --commands             # list all commands
miren help app.list               # help for a command (use . for spaces)
miren help "app list"             # alternative: quote the command
miren help app.list sandbox.list  # multiple commands at once

License

MIT