Skip to content

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

License

Notifications You must be signed in to change notification settings

iskandarsaleh/n-skills

 
 

Repository files navigation

n-skills

Curated by Numman Ali

Twitter Follow License agentskills.io AGENTS.md

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

Other native installers

Codex:

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

📦 Available Skills

Skill Category Source Description
dev-browser automation SawyerHood Browser automation with persistent page state
gastown tools native Multi-agent orchestrator (best with Claude Code + Opus)
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
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 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:

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 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
│   └── tools/
│       ├── gastown/           # Native skill
│       └── zai-cli/           # Native skill
└── 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

Built for developers who value simplicity.

Apache 2.0 · Made by @numman-ali

About

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

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 84.9%
  • JavaScript 14.6%
  • Shell 0.5%