gastown

Q: How to install gastown?

Add a marketplace: /plugin marketplace add . Then add the config to /plugin install gastown@ . Finally, /plugin in Claude Code.

Q: What is gastown best for?

gastown is categorized under Development. It covers: agent.

New

935Community RegistryDevelopmentby Numman Ali

Multi-agent orchestrator for Claude Code. Use when user mentions gastown, gas town, gt commands, convoys, polecats, rigs, slinging work, multi-agent coordination.

First seen 5/22/2026

View Source

Summary

Gastown is a multi-agent orchestrator for Claude Code that enables teams of AI agents to collaborate on complex software tasks.

It provides a universal skill format and marketplace for sharing agent capabilities across different coding environments, allowing developers to coordinate multiple agents (called 'polecats') in 'convoys' to sling work efficiently.

Overview

Curated by [Numman Ali](https://x.com/nummanali)

![Twitter Follow](https://x.com/nummanali) ![License](LICENSE) ![agentskills.io](https://agentskills.io) ![AGENTS.md](https://www.infoq.com/news/2025/08/agents-md/)

One marketplace. Every agent.

Install · Skills · Submit a Skill · Philosophy

</div>

💡 Philosophy

"Write once. Run everywhere."

AI coding agents are evolving fast, and each has its own way of doing things:

code

Claude Code    →  CLAUDE.md, .claude/skills/
GitHub Copilot →  AGENTS.md, copilot-instructions.md
Codex          →  SKILL.md, ~/.codex/skills/
Cursor         →  .cursor/rules/*.mdc
Windsurf       →  Cascade Rules, Memories
Cline          →  .clinerules
Factory/Droid  →  .factory/droids/*.md
OpenCode       →  .opencode/skill/, opencode.json

The n-skills Way

We embrace the diversity with a universal approach:

code

┌─────────────────────────────────────────────────────────┐
│                                                         │
│   SKILL.md          →  The universal skill format      │
│   AGENTS.md         →  The universal discovery file    │
│   openskills        →  The universal installer         │
│                                                         │
│   Write once. Run everywhere.                          │
│                                                         │
└─────────────────────────────────────────────────────────┘

AGENTS.md is now adopted by 20,000+ repositories and natively supported by GitHub Copilot, Google Gemini, OpenAI Codex, Factory Droid, Cursor, and more.

n-skills is a curated marketplace. Install via openskills or use your agent's native installer — your choice!

🚀 Quick Start

Claude Code

bash

/plugin marketplace add numman-ali/n-skills

Then install any skill:

bash

/plugin install orchestration@n-skills
/plugin install open-source-maintainer@n-skills
/plugin install gastown@n-skills
/plugin install dev-browser@n-skills
/plugin install zai-cli@n-skills

OpenSkills (Universal)

Works with every agent: Claude Code, Cursor, Windsurf, Cline, OpenCode, and anything that reads AGENTS.md.

bash

npm i -g openskills
openskills install numman-ali/n-skills
openskills sync

New to OpenSkills? It's the universal skills installer. Learn more →

<details> <summary><strong>Other native installers</strong></summary>

Codex:

bash

$skill-installer https://github.com/numman-ali/n-skills/tree/main/skills/tools/zai-cli

</details>

📦 Available Skills

Skill	Category	Source	Description
[orchestration](./skills/workflow/orchestration/)	`workflow`	native	Multi-agent orchestration with cc-mirror tasks + TodoWrite
[open-source-maintainer](./skills/workflow/open-source-maintainer/)	`workflow`	native	End-to-end GitHub repo maintenance for open-source projects
[dev-browser](./skills/automation/dev-browser/)	`automation`	SawyerHood	Browser automation with persistent page state
[gastown](./skills/tools/gastown/)	`tools`	native	Multi-agent orchestrator (best with Claude Code + Opus)
[zai-cli](./skills/tools/zai-cli/)	`tools`	native	Z.AI vision, search, reader, and GitHub exploration via MCP

More skills coming soon. Want to contribute? See CONTRIBUTING.md

🗂️ Categories

Category	What goes here
`workflow`	Multi-agent orchestration, task coordination
`tools`	CLI tools and utilities
`development`	Language-specific dev assistance
`productivity`	Workflow automation
`automation`	Browser, CI/CD, system automation
`data`	Databases, data processing
`documentation`	Docs, diagrams, specs

🎯 Want to be Featured?

This is a curated marketplace. Anyone can request to be included, but only high-quality, real value-add projects will be considered.

What we're looking for:

•Skills that solve real problems
•Clean, well-documented code
•Genuine utility for developers
•Active maintenance

Not interested in:

•Wrapper skills with no real value
•Abandoned or unmaintained projects
•Low-effort submissions

How to Submit

Open an issue with your skill details
Explain what it does and why it's valuable
If approved, submit a PR following CONTRIBUTING.md

Or DM me on X: @nummanali

🌐 Universal Compatibility

n-skills works everywhere because we use open standards:

Agent	How it works	Status
Claude Code	Native plugin system	✅ Native
GitHub Copilot	Reads AGENTS.md directly	✅ Native
Codex	$skill-installer	✅ Native
Factory/Droid	Reads AGENTS.md directly	✅ Native
Cursor	openskills → AGENTS.md	✅ Universal
Windsurf	openskills → AGENTS.md	✅ Universal
Cline	openskills → AGENTS.md	✅ Universal
OpenCode	Native skill support	✅ Native
Amp Code	openskills → AGENTS.md	✅ Universal

🔄 Auto-Sync from Upstream

External skills stay in sync with their source repos automatically.

code

┌─────────────────────────────────────────────────────────────┐
│                                                             │
│   Your Repo              n-skills                           │
│   ────────              ────────                            │
│   skills/my-skill/  ──►  skills/category/my-skill/         │
│                                                             │
│   Daily cron syncs your latest changes.                    │
│   You maintain ownership. We curate the collection.        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

How it works:

You maintain your skill in your own repo
Add an entry to `sources.yaml` via PR
GitHub Actions syncs your skill folder daily
Attribution preserved via .source.json

Why not submodules? Submodule hell is real. This approach is simpler and works with openskills, Claude Code, and every other tool without special handling.

📁 Repository Structure

code

n-skills/
├── .claude-plugin/
│   └── marketplace.json       # Claude Code registry
├── .github/workflows/
│   └── sync-skills.yml        # Daily sync automation
├── scripts/
│   ├── sync-external.mjs      # Sync engine
│   └── update-registry.mjs    # Registry generator
├── sources.yaml               # External skill manifest
├── AGENTS.md                  # Universal discovery
├── skills/
│   ├── automation/
│   │   └── dev-browser/              # Synced from SawyerHood
│   │       ├── .claude-plugin/
│   │       └── skills/dev-browser/   # SKILL.md lives here
│   ├── tools/
│   │   ├── gastown/
│   │   │   ├── .claude-plugin/
│   │   │   └── skills/gastown/
│   │   └── zai-cli/
│   │       ├── .claude-plugin/
│   │       └── skills/zai-cli/
│   └── workflow/
│       ├── orchestration/
│       │   ├── .claude-plugin/
│       │   └── skills/orchestration/
│       └── open-source-maintainer/
│           ├── .claude-plugin/
│           └── skills/open-source-maintainer/
└── docs/
    ├── skill-format.md        # How to write skills
    ├── cross-platform.md      # Multi-agent compatibility
    └── categories.md          # Category guidelines

🔗 Related Projects

•[openskills](https://github.com/numman-ali/openskills) — Universal skills installer for all AI agents
•[zai-cli](https://github.com/numman-ali/zai-cli) — Z.AI capabilities via CLI and MCP
•[agentskills.io](https://agentskills.io) — The open standard for AI agent skills

Built for developers who value simplicity.

Apache 2.0 · Made by @numman-ali

</div>

Install & Usage

Add a marketplace

/plugin marketplace add <org/repo>

Install the plugin

Add the configuration to /plugin install gastown@<marketplace>

Manage with /plugin

/plugin

Use Cases

Orchestrating multiple Claude Code agents to work on different parts of a large codebase simultaneously.

Defining and sharing reusable agent skills across a team using the universal SKILL.md format.

Creating a convoy of specialized agents for tasks like code review, testing, and deployment.

Using gastown commands to assign work to rigs (agent groups) for parallel execution.

Integrating agent skills from the n-skills marketplace into existing Claude Code workflows.

Managing multi-step development pipelines with agent coordination and handoffs.

Usage Examples

/gastown create convoy for refactoring the authentication module with three polecats

/gastown sling work to rig: fix all linting errors in src/ directory

Set up a multi-agent pipeline: one agent writes tests, another implements features, and a third reviews code

View source on GitHub

agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is gastown?

Gastown is a multi-agent orchestrator for Claude Code that enables teams of AI agents to collaborate on complex software tasks. It provides a universal skill format and marketplace for sharing agent capabilities across different coding environments, allowing developers to coordinate multiple agents (called 'polecats') in 'convoys' to sling work efficiently.

How to install gastown?

To install gastown: add a marketplace (/plugin marketplace add <org/repo>), then add the config to /plugin install gastown@<marketplace>. Finally, /plugin in Claude Code.

What is gastown best for?

gastown is a plugin categorized under Development. It is designed for: agent. Created by Numman Ali.

What can I use gastown for?

gastown is useful for: Orchestrating multiple Claude Code agents to work on different parts of a large codebase simultaneously.; Defining and sharing reusable agent skills across a team using the universal SKILL.md format.; Creating a convoy of specialized agents for tasks like code review, testing, and deployment.; Using gastown commands to assign work to rigs (agent groups) for parallel execution.; Integrating agent skills from the n-skills marketplace into existing Claude Code workflows.; Managing multi-step development pipelines with agent coordination and handoffs..