README.md

Curated by Numman Ali

One marketplace. Every agent.

Install · Skills · Submit a Skill · Philosophy

💡 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 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

/plugin marketplace add numman-ali/n-skills

Then install any skill:

/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.

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

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

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

📦 Available Skills

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

🗂️ Categories

🎯 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 with your skill details
2. Explain what it does and why it's valuable
3. 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:

🔄 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 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 — Universal skills installer for all AI agents
• zai-cli — Z.AI capabilities via CLI and MCP
• agentskills.io — The open standard for AI agent skills