KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

n-skills

★ 1,037 Open GitHub ↗

Curated plugin marketplace for AI agents - works with Claude Code, Codex, and openskills

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

[![Twitter Follow](https://img.shields.io/twitter/follow/nummanali?style=social)](https://x.com/nummanali)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://raw.githubusercontent.com/numman-ali/n-skills/main/LICENSE)
[![agentskills.io](https://img.shields.io/badge/format-agentskills.io-purple.svg)](https://agentskills.io)
[![AGENTS.md](https://img.shields.io/badge/discovery-AGENTS.md-green.svg)](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

---

**Built for developers who value simplicity.**

Apache 2.0 · Made by [@numman-ali](https://github.com/numman-ali)

</div>

n-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README