Metadata-Version: 2.4
Name: skillhub-cli
Version: 0.1.0
Summary: Skill registry for AI coding agents — install, search, and publish skills for Claude Code, Codex, Cursor, Aider, and more
License-Expression: MIT
Project-URL: Homepage, https://github.com/aayuvraj/skillhub
Project-URL: Repository, https://github.com/aayuvraj/skillhub
Keywords: claude-code,codex,cursor,aider,ai-agent,skills,developer-tools
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown

<div align="center">

# skillhub

**The skill registry for AI coding agents.**

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI](https://img.shields.io/pypi/v/skillhub)](https://pypi.org/project/skillhub)
[![Works with Claude](https://img.shields.io/badge/Claude%20Code-✓-blue)](https://claude.ai/code)
[![Works with Codex](https://img.shields.io/badge/Codex-✓-green)](https://openai.com/codex)
[![Works with Cursor](https://img.shields.io/badge/Cursor-✓-purple)](https://cursor.sh)

```bash
skillhub install security-review
skillhub install pipe --platform cursor
skillhub search refactor
```

*npm for AI coding agent skills. One command to find, install, and publish.*

</div>

---

## The Problem

AI coding agent skills spread via blog posts, Substack threads, and copy-paste.

There is no `npm install`. No version control. No discovery. No standard format.

You either write skills from scratch or spend 30 minutes hunting through GitHub for one someone else built.

## The Solution

skillhub is a registry for AI coding agent skills — like npm, but for `SKILL.md` files.

```bash
pip install skillhub

skillhub search security          # find what you need
skillhub install security-review  # install in one command
skillhub publish                  # share what you build
```

Skills install to the right place automatically based on your agent. No manual copy-paste.

---

## Install

```bash
pip install skillhub
```

---

## Usage

### Search

```bash
skillhub search security
skillhub search refactor
skillhub search pipeline
```

### Install

```bash
skillhub install pipe                              # auto-detects your agent
skillhub install graphify --platform claude        # specific platform
skillhub install security-review --platform cursor
```

### List all skills

```bash
skillhub list
```

### Get skill details

```bash
skillhub info pipe
```

### Publish your skill

```bash
skillhub publish
```

---

## Supported Agents

| Agent | Install location |
|-------|-----------------|
| **Claude Code** | `~/.claude/skills/<name>/SKILL.md` |
| **Codex** | appended to `AGENTS.md` |
| **Cursor** | `.cursor/rules/<name>.mdc` |
| **Aider** | appended to `AGENTS.md` |
| **OpenCode** | appended to `AGENTS.md` |
| **Claw** | appended to `AGENTS.md` |
| **Gemini CLI** | appended to `GEMINI.md` |

skillhub auto-detects your agent. Pass `--platform` to override.

---

## Registry

Skills in the registry:

| Skill | Description | Author |
|-------|-------------|--------|
| `pipe` | Chain skills into pipelines with `->` syntax | [@aayuvraj](https://github.com/aayuvraj) |
| `graphify` | Turn any codebase into a queryable knowledge graph | [@safishamsi](https://github.com/safishamsi) |
| `review` | Pre-landing PR review — SQL, trust boundaries, side effects | [@garrytan](https://github.com/garrytan) |
| `investigate` | Root cause debugging — 4-phase systematic process | [@garrytan](https://github.com/garrytan) |
| `code-review` | Multi-axis review: correctness, security, performance | [@addyosmani](https://github.com/addyosmani) |
| `debug` | Structured triage for failures, errors, and incidents | [@addyosmani](https://github.com/addyosmani) |
| `tdd` | Test-driven development — failing test first, then code | [@addyosmani](https://github.com/addyosmani) |
| `plan` | Decompose work into verifiable tasks with acceptance criteria | [@addyosmani](https://github.com/addyosmani) |
| `spec` | Full specification before any code — requirements, scope, criteria | [@addyosmani](https://github.com/addyosmani) |
| `performance` | Profiling-driven optimization — Core Web Vitals, load times | [@addyosmani](https://github.com/addyosmani) |
| `harden` | Security-first practices — auth, data storage, third-party inputs | [@addyosmani](https://github.com/addyosmani) |
| `document` | ADRs and docs capturing the why, not just the what | [@addyosmani](https://github.com/addyosmani) |
| `git` | Disciplined git — commits as save points, history as docs | [@addyosmani](https://github.com/addyosmani) |
| `changelog` | Generate release notes from Conventional Commits | [@alirezarezvani](https://github.com/alirezarezvani) |
| `security-review` | Deep security audit — OWASP, injection, auth flaws | community |
| `explain` | Plain-language code explanation with edge cases | community |
| `refactor` | Refactor for clarity and performance, behavior unchanged | community |

> Registry grows via community PRs. See [Contributing](#contributing).

---

## Publishing a Skill

Built something useful? Add it to the registry.

1. Fork this repo
2. Add `registry/skills/<your-skill>.md`
3. Add an entry to `registry/index.json`
4. Open a PR

Skill format:

```markdown
---
name: your-skill
description: one line description
trigger: /your-skill
platforms: claude, codex, cursor, aider, claw, opencode, gemini
---

# /your-skill

Instructions for the agent...
```

---

## Philosophy

Skills are the most underrated part of AI-assisted development.

A great skill turns a 5-minute back-and-forth into one command. A great skill library turns any agent into a specialist. But right now, skills are scattered, undiscoverable, and agent-specific.

skillhub is the missing layer: a standard format, a central registry, and a one-command install that works across every major agent.

Build once. Share everywhere.

---

## Contributing

- Add a skill to the registry
- Improve an existing skill
- Add platform support for a new agent

PRs welcome. See [Publishing a Skill](#publishing-a-skill).

---

## License

MIT

---

<div align="center">

**If this saved you time, a ⭐ helps others find it.**

[github.com/aayuvraj/skillhub](https://github.com/aayuvraj/skillhub)

</div>

<!-- SEO: claude code skills, codex agents, cursor rules, aider, ai coding agent, skill registry, skill package manager, npm for ai agents, developer productivity, slash command registry -->
