<div align="center">
<img src="./assets/logo.svg" alt="n-skills" width="400"/>
<br/>
<br/>
**Curated by [Numman Ali](https://x.com/nummanali)**
[](https://x.com/nummanali)
[](LICENSE)
[](https://agentskills.io)
[](https://www.infoq.com/news/2025/08/agents-md/)
**One marketplace. Every agent.**
[Install](#-quick-start) ยท [Skills](#-available-skills) ยท [Submit a Skill](#-want-to-be-featured) ยท [Philosophy](#-philosophy)
</div>
---
## ๐ก Philosophy
> **"Write once. Run everywhere."**
AI coding agents are evolving fast, and each has its own way of doing things:
```
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:
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ SKILL.md โ The universal skill format โ
โ AGENTS.md โ The universal discovery file โ
โ openskills โ The universal installer โ
โ โ
โ Write once. Run everywhere. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
[AGENTS.md](https://www.infoq.com/news/2025/08/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](https://github.com/numman-ali/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 โ](https://github.com/numman-ali/openskills)
<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](https://github.com/SawyerHood/dev-browser) | 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](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
1. Open an [issue](https://github.com/numman-ali/n-skills/issues) with your skill details
2. Explain what it does and why it's valuable
3. If approved, submit a PR following [CONTRIBUTING.md](CONTRIBUTING.md)
Or DM me on X: [@nummanali](https://x.com/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.
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ 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:**
1. You maintain your skill in your own repo
2. Add an entry to [`sources.yaml`](sources.yaml) via PR
3. GitHub Actions syncs your skill folder daily
4. 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
```
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
---
<div align="center">
**Built for developers who value simplicity.**
Apache 2.0 ยท Made by [@numman-ali](https://github.com/numman-ali)
</div>