open-agent-hub

open-agent-hub

English | 简体中文

A lightweight, zero-dependency CLI tool to manage and activate capabilities for AI coding assistants (such as Claude Code, Cursor, Trae, etc.). With a single command, you can link Skills (modular prompting), Agents (expert workflow roles), and Commands (slash commands) to your project workspaces or global system configurations.

---

📂 Directory Structure

.
├── agents/             # System prompts for expert Agents (agent-*.md)
├── commands/           # Agent runtime Slash Commands (*.md)
├── docs/               # Technical specs and user guidelines
├── scripts/            # CLI manager source code (hub.js)
├── skills/             # Modular capability skills (83+ skills)
├── spec/               # Technical specification definitions for capabilities
├── template/           # Development templates for Skills, Agents, and Commands
├── AGENTS.md           # Project-level LLM coding guidelines
├── CLAUDE.md           # Claude-specific coding guidelines
├── GEMINI.md           # Gemini-specific coding guidelines
├── CHANGELOG.md        # Changelog of project versions
├── CONTRIBUTING.md     # Community guidelines for contributions
├── LICENSE             # MIT license file
├── SECURITY.md         # Vulnerability reporting policies
├── package.json        # CLI configuration and npm registration
├── skills_index.json   # Scanned and generated global metadata index for skills
├── skills_sources.json # Data sources configuration for `oah sync` command
├── README.md           # English documentation (this file)
└── README.zh-CN.md     # Chinese translation documentation

(Note: AGENTS.md, CLAUDE.md, and GEMINI.md contain project-level LLM coding behavioral guidelines, derived from andrej-karpathy-skills)

---

📖 Technical Guidelines & Documentation

To maintain clean and focused documentation, deep-dive specifications have been moved under the docs/ directory. Please refer to:

• 🧩 Skill Guidelines: Design standards, trigger rules, and a complete catalog of the 83+ modular skills.
• 🤖 Agent Guidelines: Specifications for Orchestrator, Evaluator, and Optimizer agent roles, detailing handoff contracts and Evaluator-Optimizer loops.
• 🛠 Command Guidelines: Guidelines for agent-facing slash commands (such as /commit, /review, and /test-tdd).

---

🔌 Compatibility

open-agent-hub follows standardized Markdown prompts with YAML frontmatter metadata. The CLI dynamically links components (Skills, Agents, Commands) to their respective subdirectories (/skills/, /agents/, /commands/) within the project or global configuration directories of the AI assistant:

Tool Name (Agent)	Type	Compatibility	Project Path (Workspace)	Global Path (System)
Claude Code	CLI	✅ Full	.claude/	~/.claude/
Antigravity	IDE	✅ Full	.agents/	~/.gemini/antigravity/
Gemini CLI	CLI	✅ Full	.gemini/	~/.gemini/
Codex	CLI	✅ Full	.codex/	~/.codex/
Cursor	IDE	✅ Full	.cursor/	~/.cursor/
Trae	IDE	✅ Full	.trae/	~/.trae/
OpenCode	CLI	✅ Full	.opencode/	~/.config/opencode/
Kiro	CLI/Agent	✅ Full	.kiro/	~/.kiro/

[!TIP] The CLI tool (oah) links files into subdirectories under these paths, e.g., <Path>/skills/ for skills, <Path>/agents/ for agents, and <Path>/commands/ for slash commands.

---

🚀 Quick Start

1. Clone the Hub

Clone this repository locally (it is recommended to place it in a fixed location for global reference):

git clone https://github.com/guanyang/open-agent-hub.git ~/open-agent-hub

2. Global Link via CLI

In the root directory, run the link command to register the CLI manager open-agent (with aliases open-agent-hub, oah, ahub):

cd ~/open-agent-hub
npm link

3. Manage Capabilities

After linking, you can manage your local agent environments from anywhere:

# List all dynamically scanned Skills, Agents, and Commands
oah list

# Check link status in your current project workspace (default behavior)
oah status

# Check link status in global system configurations (e.g. ~/.claude/)
oah status --global

# Enable a specific component inside the current project workspace
oah enable canvas-design

# Enable all components (Skills, Agents, Commands) in current project workspace (defaults to all)
oah enable

# Enable all components in project workspace for Cursor (links to .cursor/)
oah enable --target=cursor

# Enable all components in project workspace for ALL supported targets
oah enable --target=all

# Enable all components globally for ALL supported targets
oah enable --global --target=all