mux-swarm

Authoritative user guide + reference map for Mux-Swarm itself (v0.12.1). Use when the user asks how Mux works, how to configure it, what a command/flag/config-key does, how modes/teams/sandbox/auth/ACP/delegation work, or how to troubleshoot Mux. Points to exact sections in the bundled DOCS.md instead of dumping it.

Structured diff and PR code review with a prioritized checklist. Use when reviewing staged changes, pull requests, or any code diff before merge.

Profile, clean, and analyze tabular data (CSV/JSON/Parquet) with pandas/polars. Use when exploring datasets, computing aggregations, joining tables, resampling time series, or producing analysis charts.

Find vulnerable and outdated dependencies across ecosystems (Python, Node, .NET, Rust, Go). Use when auditing a project for CVEs, preparing a release, or investigating a security report.

Design distinctive, polished UI that avoids generic 'AI slop'. Use when making visual design decisions: typography, color, spacing, hierarchy, motion, and component composition.

Run real SAST and secret-scanning tools locally (semgrep, bandit, gitleaks, trivy). Use when auditing a codebase for vulnerabilities, exposed secrets, or vulnerable dependencies before shipping or on demand.

Safe schema-aware SQL querying against CSV/Parquet/JSON files, SQLite databases, and live Postgres. Use when querying structured data, profiling a schema, or building data pipelines.

Generate and run unit/integration tests TDD-style across Python, Node, and .NET. Use when adding tests to untested code, implementing a feature test-first, or finding coverage gaps.

Design usable, accessible, humane interfaces — interaction patterns, component states, forms, feedback, and WCAG compliance. Use when making decisions about how UI behaves, not just how it looks.

Create, read, and edit Excel workbooks with formulas, formatting, charts, and template preservation. Use when working with .xlsx/.xls files, spreadsheet generation, or bulk tabular data IO.

Launch and manage Mux Swarm CLI instances in Docker containers with full bidirectional communication. Enables spawning isolated agent sessions, switching between agents, and orchestrating multi-agent workflows in containerized environments. Use when you need process isolation, reproducible environments, or want to run Mux Swarm in a container. Triggers on requests like "launch mux in docker", "start a containerized mux session", "run mux swarm in a container", or "isolated mux environment".

Run code in isolated Docker containers with pre-installed dependencies. Use for all tasks requiring any code execution, specific libraries, or file generation

Summarize Mux session folders into a clean markdown report. Use when you need fast context at task start, want to review tool calls, delegated agents, artifacts, or outcomes across one or more sessions.

Install bundled skills into local skills directory from curated lists or GitHub repos. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

C# and .NET 8+ coding conventions, naming standards, idiomatic patterns, CLI commands, dependency management, testing with xUnit, and XML documentation. Use when writing, reviewing, or refactoring C# code.

Best practices for creating, editing, and manipulating Word documents (.docx files) using Python. Use when creating reports, memos, letters, templates, or any .docx output. Also use when reading, editing, or extracting content from existing Word documents.

Generate runnable MCP servers from Swagger/OpenAPI specifications using the mcp-swagger-cli tool. Use when the user wants to turn any REST API into an MCP server, integrate a third-party API into an agent workflow, or generate MCP tools from an OpenAPI/Swagger spec (JSON or YAML, local file or URL).

Launch and interact with Mux Swarm CLI subprocesses. Use when you need to spawn a separate Mux Swarm instance, communicate with agents programmatically, or run autonomous sessions in the background. Triggers on requests like "launch a mux subprocess", "start a background mux session", "talk to another agent instance", or "run mux swarm as a subprocess".

Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter; prefer visual checks by rendering pages and use Python tools such as reportlab, pdfplumber, and pypdf for generation and extraction.

Professional PowerPoint presentation creation, editing, and automation with support for layouts, templates, charts, images, and formatting. Use when working with .pptx files for: (1) Creating presentations from scratch, (2) Editing existing presentations, (3) Applying templates and themes, (4) Adding charts and visualizations, (5) Bulk slide generation, (6) Presentation automation

Guide for creating, updating, and packaging skills. Use when a user wants to create a new skill, improve an existing skill, or package a skill for distribution. Triggers on requests like "create a skill", "make a new skill for X", "update this skill", or "package this skill".

Use this skill when performing general system administration tasks across Windows, macOS, or Linux, such as configuring OS settings, managing packages/software, interacting with services, or network operations.

Solve CAPTCHAs using 2Captcha service via CLI. Use for bypassing captchas during web automation, account creation, or form submission.

Optimize prompts for better LLM responses. Use when users want to improve prompt clarity, add structure, enhance specificity, or need prompt templates for specific tasks. Uses CodeAgent for analysis and generation, and MemoryAgent for storing optimized prompts.

Convert Unix/Linux-based skill.md files to {{os}} equivalents. Use when you need to transform a skill that contains Unix/Linux-specific commands, paths, and tools into a version that works on {{os}}. Takes a file path to an input skill.md and outputs a converted _{{os}}.md version.

Build, manage, and configure Docker images and containers. Use when creating new sandbox environments, adding packages to existing images, or managing the Docker image catalog.

Best practices for creating, editing, and manipulating Word documents (.docx files). Use when creating reports, memos, letters, templates, or any .docx output. Also use when reading, editing, or extracting content from existing Word documents.

Patterns for diagnosing failures, reading error output, adapting approach, and recovering from errors without repeating the same mistake.

Guide for using git through the git-container Docker container. All git operations must use the git-container for isolation.

Best practices for creating well-structured markdown reports, summaries, documentation, and written deliverables saved to files.

Generate runnable MCP servers from Swagger/OpenAPI specifications using the mcp-swagger-cli tool inside Docker. Use when the user wants to turn any REST API into an MCP server, integrate a third-party API into an agent workflow, or generate MCP tools from an OpenAPI/Swagger spec (JSON or YAML, local file or URL).

Use this skill when adding a new agent to the swarm configuration. Covers swarm.json syntax, security rules, prompt file creation, and canDelegate guidance.

Use when tasks involve reading, creating, or reviewing PDF files where rendering and layout matter. Runs inside Docker with reportlab, pdfplumber, pypdf, and poppler pre-installed.

Python coding guidelines and best practices. Use when writing, reviewing, or refactoring Python code. Enforces PEP 8 style, syntax validation via py_compile, unit test execution, modern Python versions only (no EOL), uv for dependency management when available, and idiomatic Pythonic patterns.

Summarize Mux session folders into a clean markdown report. Use when you need fast context at task start, want to review tool calls, delegated agents, artifacts, or outcomes across one or more sessions.

Guide for creating, updating, and packaging skills. Use when a user wants to create a new skill, improve an existing skill, or package a skill for distribution. Triggers on requests like "create a skill", "make a new skill for X", "update this skill", or "package this skill".

Install bundled skills into local skills directory from curated lists or GitHub repos. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

Use this skill when performing general system administration tasks across Windows, macOS, or Linux, such as configuring OS settings, managing packages/software, interacting with services, or network operations.

Best practices for conducting web research, gathering current information, cross-referencing sources, and producing well-structured research outputs.

Guide for using git directly on the host system via the OS shell tool. Use when performing any git operations — clone, pull, push, commit, branch, etc.