guanyang/open-agent-hub

English | 简体中文

AI 코딩 어시스턴트(Claude Code, Cursor, Trae 등)의 기능을 관리하고 활성화하기 위한 가볍고 의존성이 없는 (zero-dependency) CLI 도구입니다. 단 한 번의 명령으로 Skills (모듈형 프롬프팅), Agents (전문가 워크플로우 역할), 그리고 Commands (슬래시 명령어)를 프로젝트 워크스페이스 또는 글로벌 시스템 설정에 연결할 수 있습니다.

.
├── agents/ # 전문가 Agent를 위한 시스템 프롬프트 (agent-*.md)
├── commands/ # Agent 런타임 슬래시 명령어 (*.md)
...

(참고: AGENTS.md, CLAUDE.md, GEMINI.md는 andrej-karpathy-skills에서 파생된 프로젝트 수준의 LLM 코딩 행동 지침을 포함합니다)

깔끔하고 집중된 문서를 유지하기 위해, 심층 사양(deep-dive specifications)은 docs/ 디렉토리로 이동되었습니다. 다음을 참조하십시오:

• 🧩 Skill Guidelines: 설계 표준, 트리거 규칙, 그리고 83개 이상의 모듈형 기술(skills)에 대한 전체 카탈로그.
• 🤖 Agent Guidelines: Orchestrator, Evaluator, Optimizer Agent 역할에 대한 사양으로, 핸드오프 계약(handoff contracts) 및 Evaluator-Optimizer 루프에 대해 상세히 설명합니다.
• 🛠 Command Guidelines: Agent 대상 슬래시 명령어(예: /commit, /review, /test-tdd)에 대한 가이드라인.

open-agent-hub는 YAML 프론트매터(frontmatter) 메타데이터가 포함된 표준화된 Markdown 프롬프트를 따릅니다. CLI는 구성 요소(Skills, Agents, Commands)를 AI 어시스턴트의 프로젝트 또는 글로벌 설정 디렉토리 내의 해당 하위 디렉토리(/skills/, /agents/, /commands/)에 동적으로 연결합니다:

도구 이름 (Agent)	유형	호환성	프로젝트 경로 (워크스페이스)	글로벌 경로 (시스템)
Claude Code	CLI	✅ 전체 지원	.claude/	~/.claude/
Antigravity	IDE	✅ 전체 지원	.agents/	~/.gemini/antigravity/
Gemini CLI	CLI	✅ 전체 지원	.gemini/	~/.gemini/
Codex	CLI	✅ 전체 지원	.codex/	~/.codex/
Cursor	IDE	✅ 전체 지원	.cursor/	~/.cursor/
Trae	IDE	✅ 전체 지원	.trae/	~/.trae/
OpenCode	CLI	✅ 전체 지원	.opencode/	~/.config/opencode/

Tip

CLI 도구 (oah

)는 이 경로들 아래의 하위 디렉터리에 파일들을 링크합니다. 예: <Path>/skills/는 스킬 (skills)용, <Path>/agents/는 에이전트 (agents)용, 그리고 <Path>/commands/는 슬래시 커맨드 (slash commands)용입니다.

이 저장소를 로컬에 클론(Clone)하세요 (전역 참조를 위해 고정된 위치에 배치하는 것을 권장합니다):

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

루트 디렉터리에서 link 명령을 실행하여 CLI 매니저 open-agent (별칭: open-agent-hub, oah, ahub)를 등록하세요:

cd ~/open-agent-hub
npm link

링크를 마친 후에는 어디에서든 로컬 에이전트 환경을 관리할 수 있습니다:

# 동적으로 스캔된 모든 스킬 (Skills), 에이전트 (Agents), 커맨드 (Commands) 목록 표시
oah list
# 현재 프로젝트 워크스페이스의 링크 상태 확인 (기본 동작)
...

필터 (Filters) (이름 인자로 전달되며, 상호 배타적임):
<name>: 이름/ID를 통해 단일 컴포넌트를 활성화/비활성화합니다.
--skills: 모든 스킬 (Skills) 컴포넌트만 활성화/비활성화합니다.
--agents: 모든 에이전트 (Agents) 컴포넌트만 활성화/비활성화합니다.
--commands: 모든 커맨드 (Commands) 컴포넌트만 활성화/비활성화합니다.
--all, -a: 모든 스킬 (Skills), 에이전트 (Agents), 커맨드 (Commands)를 활성화/비활성화합니다 (인자가 제공되지 않을 때의 기본 동작).

옵션 (Options):
-p, --project (기본값): 프로젝트 레벨 활성화 (현재 작업 디렉터리 내부의 설정 디렉터리를 링크합니다. 예: .claude/).
-g, --global: 시스템 전역 레벨 활성화 (예: ~/.claude/와 같이 사용자 홈 설정 폴더에 링크합니다).
-t, --target <name>: 링크할 대상 환경 (지원 대상: claude, antigravity, gemini, codex, cursor, trae, opencode 및 모든 환경을 구성하기 위한 all, 기본값: claude).
--path <dir_path>: 컴포넌트를 링크할 사용자 정의 기본 디렉터리 (skills/, agents/, commands/ 하위 디렉터리를 자동으로 생성하고 그 안에 링크합니다).

skills/ 디렉터리에 있는 많은 모듈형 스킬 (modular skills)들은 활발한 오픈 소스 커뮤니티에서 유래되었습니다. CLI 또는 기반 스크립트를 사용하여 이를 업스트림 (upstream) 소스와 동기화할 수 있습니다:

# 설정된 모든 소스 동기화
oah sync
# 특정 소스만 동기화 (예: anthropics-skills)
...

참고: 설정된 업스트림 (upstream) 소스는 skills_sources.json에 저장됩니다. 또한 ./scripts/sync_skills.sh를 통해 이를 직접 실행할 수도 있습니다.

보안 정책 (Security Policy): 취약점을 보고하려면 SECURITY.md를 참조하십시오. 기여하기 (Contributing): 새로운 스킬 (skills), 에이전트 (agents) 또는 명령 (commands)에 대한 커뮤니티의 기여를 환영합니다. 가이드라인은 CONTRIBUTING.md를 참조하십시오.

이 프로젝트는 MIT 라이선스 (MIT License) 하에 라이선스가 부여됩니다.