ONEDEV

open-agent-hub

AI Coding ToolsskillTypeScript

★ 969주당 +3조회 4

무엇인가

open-agent-hub는 AI 코딩 에이전트가 따를 스킬·에이전트 역할·슬래시 명령을 한 저장소에서 관리하고, 필요한 것만 각 프로젝트 작업 공간이나 전역 설정에 연결해 활성화하는 CLI 도구다. 규율 대상은 개별 규칙의 문장이 아니라 "어떤 규칙 파일이 어느 작업 공간에 붙어 있는가"라는 배포·활성화 계층이다. 여러 에이전트 환경에 같은 능력 집합을 일관되게 배치하고, 프로젝트별로 켜고 끄는 절차를 정의한다.

어떻게 동작하나

저장소는 skills/, agents/, commands/ 세 디렉터리로 능력을 나누고, 각 파일은 YAML 프런트매터를 가진 마크다운 프롬프트로 작성한다. scripts/hub.js가 CLI 본체이며 skills_index.json에 스캔된 메타데이터 색인을 생성한다. oah enable은 대상 디렉터리의 /skills/, /agents/, /commands/ 하위 경로로 파일을 심볼릭 링크하고, oah disable은 그 링크를 해제한다. 링크 대상은 현재 프로젝트 작업 공간이 기본값이고 --global을 주면 ~/.claude/ 같은 시스템 전역 설정으로 바뀐다. Claude Code·Codex·Cursor용 네이티브 플러그인 설정(.claude-plugin/, .codex-plugin/, .cursor-plugin/)도 함께 제공한다.

무엇과 다른가

규칙을 프로젝트마다 직접 복사하거나 단일 CLAUDE.md에 몰아넣는 방식과 달리, 원본을 한 곳에 두고 심볼릭 링크로 참조한다. 따라서 규칙 수정이 연결된 모든 작업 공간에 반영되고, 프로젝트별로 켜진 능력 집합을 다르게 가져갈 수 있다. 또 스킬·에이전트·명령을 --skills, --agents, --commands 필터로 구분해 활성화하므로, 단일 규칙 파일이 아니라 세 종류의 구성 요소를 독립적으로 조합한다.

어떻게 쓰나

설치 경로는 두 가지다. 스킬만 필요하면 npx skills@latest add guanyang/open-agent-hub로 저장소에서 직접 설치하고, --skill 옵션으로 개별 스킬을 지정한다. 에이전트와 슬래시 명령까지 링크로 관리하려면 저장소를 클론한 뒤 루트에서 npm link를 실행해 oah(별칭 open-agent, open-agent-hub, ahub)를 등록한다. 이후 oah list로 스캔된 구성 요소를 나열하고, oah status로 현재 작업 공간의 링크 상태를, oah enable <이름>으로 개별 활성화를 수행한다. --target=cursor, --target=all로 대상 에이전트를 지정하고, --path로 임의 디렉터리에 하위 구조를 자동 생성해 연결할 수 있다.

전제와 한계

CLI는 npm 기반이라 Node.js 환경이 필요하고, 파일을 복사하지 않고 심볼릭 링크로 붙이므로 링크를 지원하는 파일 시스템에서만 동작한다. 지원 대상은 Claude Code, Cursor, Codex, Trae 등이며 각 에이전트의 설정 디렉터리 규약에 의존한다. Vercel skills CLI 경로는 스킬만 다루고 에이전트·명령은 다루지 않는다. 저장소의 AGENTS.md·CLAUDE.md·GEMINI.md는 허브 저장소 자체의 코딩 지침이며 andrej-karpathy-skills에서 파생된 것으로, 사용자 프로젝트에 자동 적용되는 규칙 파일은 아니다.

유사 도구