ai-omni-skills
요약
ai-omni-skills v1.4.0은 파편화된 AI 코딩 기술(skills)을 하나의 정형화된 저장소로 통합하고 다양한 AI 도구와 동기화하는 CLI 및 MCP 서버입니다. Claude, Cursor, Gemini 등 여러 도구 간의 설정 중복과 기술 고립 문제를 해결합니다.
핵심 포인트
- 다양한 AI 코딩 도구 간의 기술(skills) 통합 및 동기화 지원
- CLI 및 MCP 서버를 통한 단일 정형화 저장소(canonical store) 구축
- macOS, Linux, Windows용 네이티브 바이너리 및 Homebrew 지원
- 도구별 설정 파편화 및 중복 문제를 해결하는 스킬 컴파일러 파이프라인 제공
저는 모든 AI 도구를 사용해 보려고 노력합니다. 하지만 저의 기술(skills)들은 여기저기 흩어져 있습니다. 이 도구는 그것들을 하나로 통합합니다.
🎉 v1.4.0 출시 — macOS, Linux, Windows용 네이티브 바이너리; Homebrew 및 Winget 지원; 그리고 스킬 컴파일러 파이프라인(skill compiler pipeline)이 포함되었습니다. 공지사항 읽기 →
모든 AI 코딩 도구에 걸쳐 수집한 기술(skills)을 가져와 하나의 정형화된 저장소(canonical store)로 통합하는 CLI + MCP 서버입니다. 그런 다음 이를 사용하는 모든 도구 — Claude, Codex, Kimi, Gemini, Cursor, Zed, Cline, Z.AI 및 기타 모든 도구에 동기화합니다.
이 프로젝트가 유용하다고 생각하신다면, 저장소(repo)에 별(star)을 눌러주세요. 이는 저희가 homebrew/core에 포함되기 위한 기준을 충족하는 데 도움이 됩니다.
그러면 사용자들이 brew tap 단계를 거치지 않고도
brew install omni-skills를 실행할 수 있습니다.
모든 새로운 AI 코딩 도구는 자신만의 지침 파일(instruction file), 기술 디렉토리(skill directory), 그리고 설정(configuration)을 요구합니다. 그 결과 파편화가 발생합니다:
| 혼란 | 발견한 내용 |
|---|---|
| 중복된 AGENTS.md 파일 | 16개 프로젝트에 걸쳐 동일한 템플릿 70개 복제 |
| 고립된 기술 (Orphaned skills) | 특정 도구의 기술 디렉토리에 숨겨져 있어 다른 도구에서는 보이지 않는 15개의 기술 |
| 마켓플레이스 덤프 (Marketplace dumps) | 프로젝트로 복제된 203개의 일반적인 기술 |
| 오래된 템플릿 (Stale templates) | 모든 저장소(repo)에 있는 오래된 프로젝트 전용 규칙 |
| 개인 기술 유출 (Private skills leaking) | 일반 기술과 섞여 있는 프로젝트 특정 기술 |
| 철칙의 표류 (Iron laws drifting) | 저장소 간에 수동으로 복사하여 붙여넣는 98KB 크기의 지침 파일 |
| 새로운 도구 = 수동 설정 | 새로운 AI 도구가 나올 때마다 설정 파일을 하나씩 복사해야 함 |
Omni Skills는 단일 목적의 도구입니다: 모든 기술을 찾아 한곳에 모으고, 당신이 사용하는 모든 AI 도구에 연결합니다.
# 하나의 정형화된 저장소. 모든 도구가 이를 확인합니다.
omni-skills sync all # Claude, Codex, Kimi, Gemini, Cursor, Cline, Zed, 등.
다음 중 하나를 선택하세요. 네이티브 바이너리(Native binaries)는 Node.js를 필요로 하지 않습니다.
# macOS / Linux
brew tap moatazhamada/tap
brew install omni-skills
...
왜 brew tap이 필요한지, 그리고 각 배포 채널이 어떻게 작동하는지에 대한 자세한 내용은 docs/install.md를 참조하세요.
당신의 스킬을 위한 별도의 개인 (private) 저장소가 필요합니다. 이 툴킷 (toolkit)은 스킬을 포함하고 있지 않습니다. 대신 여러분이 이미 보유하고 있는 스킬들을 여러분이 사용하는 모든 AI 도구 (AI tool)에 연결해 줍니다.
# 1. 자동 스캔 설정 실행
omni-skills setup
# 설치된 AI 도구들을 자동 감지하고, 스킬 디렉토리를 찾습니다.
...
질문 없이 기본값을 재정의(Override)하려면 다음과 같이 사용하세요:
omni-skills setup --public=~/my-skills-public --private=~/my-skills-private
omni-skills setup --toolkit=/path/to/this/repo
| 티어 (Tier) | 대상 | 메커니즘 (Mechanism) |
|---|---|---|
| A | SKILL.md 스킬 + 공유 지침 (shared instructions) + MCP 서버 | 심볼릭 링크 (Symlinks) + list_skills / read_skill을 노출하는 로컬 MCP 서버 |
| B | 훅 (Hooks) | 각 도구의 네이티브 훅 형식으로 트랜스파일 (transpiled)된 표준 훅 |
| C | 기타 자산 (Other assets) | 설정 저장소에서 도구별 경로로 연결되는 심볼릭 링크 (Symlinks) |
omni-skills sync를 실행하면, 각 SKILL.md는 대상 도구가 기대하는 형식으로 즉석에서 컴파일 (compiled on the fly)됩니다. 또한 YAML 프론트매터 (frontmatter)에 executionBoundary 가드를 추가하여 파일 쓰기, 네트워크 액세스를 제한하거나 도구별로 셸 실행 (shell execution) 확인을 요구하도록 설정할 수 있습니다.
전체 컴파일러 파이프라인 (compiler pipeline), 실행 경계 (execution boundaries) 및 MCP 서버에 대한 자세한 내용은 docs/architecture.md를 참조하세요.
| Tool | Type | Config | Skills Dir | MCP |
|---|---|---|---|---|
| Claude Code | CLI | ~/.claude/CLAUDE.md | ✓ | ✓ |
| OpenAI Codex | CLI | ~/.codex/AGENTS.md | ✓ | ✓ |
| Kimi | CLI | ~/.kimi/AGENTS.md | ✓ | ✓ |
| Gemini CLI | CLI | ~/.gemini/GEMINI.md | — | ✓ |
| Cursor | Editor | ~/.cursor/rules/ | — | ✓ |
| Kilocode | VS Code | ~/.kilocode/rules/ | ✓ | ✓ |
| OpenCode | CLI | ~/.config/opencode/ | — | ✓ |
| Aider | CLI | ~/.aider.conf.yml | — | — |
| Continue.dev | VS Code | ~/.continue/config.yaml | — | ✓ |
| Cline | VS Code | ~/.cline/rules.md | ✓ | ✓ |
| Roo Code | VS Code | ~/.roo/rules.md | ✓ | ✓ |
| Windsurf | Editor | ~/.windsurf/rules.md | — | ✓ |
| Zed | Editor | ~/.config/zed/settings.json | — | ✓ |
| Tabby | Self-hosted | ~/.tabby/config.toml | — | — |
| PearAI | Editor | ~/.pearai/config.json | — | — |
| Void | Editor | ~/.void/config.json | — | — |
| JetBrains Junie | IDE | .junie/guidelines.md | — | — |
| JetBrains AI Assistant | IDE | .aiassistant/rules/ | — | — |
| Claude Desktop | Desktop | ~/Library/…/Claude/… | — | ✓ |
| Devin | Desktop | — | — | — |
| Factory Droid | CLI | — | — | — |
| Z.AI (GLM 5.2) | Model API | — | — | —¹ |
¹ Z.AI는 기존 도구를 통해 작동합니다. Claude Code, Cline 또는 Zed를 GLM Coding Plan 엔드포인트에 지정하세요. VS Code Copilot의 경우, glm-copilot 확장을 설치하세요.
핵심 명령어(Core commands)는 매일 사용하는 명령어입니다. 보조 명령어(Secondary commands)는 메인 인터페이스가 간결하게 유지되도록 manage 아래에 그룹화되어 있습니다.
| Command | Does |
|---|---|
| `omni-skills sync [tool | all] [--dry-run] [--no-backup]` |
omni-skills setup | 자동 스캔, 도구 감지, 설정을 생성합니다. |
omni-skills doctor | 심볼릭 링크, 설정, 인덱스, 스킬 개수를 점검합니다. |
omni-skills restore [index] [--prune[=N]] [--empty-trash] | 삭제된 파일을 목록화하거나 복원하고, 오래된 쓰레기통을 정리합니다. |
omni-skills update [--check] | 업데이트 여부를 확인합니다. |
omni-skills help | 도움말을 표시합니다. |
| 하위 명령 (Subcommand) | 기능 (Does) |
|---|---|
manage mcp | stdio를 통해 MCP 서버를 실행합니다. |
manage index | INDEX.md 및 관리되는 SHARED.md를 재생성합니다. |
| `manage workflow [list | run <name>]` |
manage check [--move] [--dry-run] | 고립된 스킬 (orphaned skills) 및 끊어진 심볼릭 링크 (dangling symlinks)를 찾습니다. |
manage classify [path] [--depth=N] [--dry-run] | 지침 파일 (instruction files)을 스캔하여 공개/비공개로 분류합니다. |
manage discover | 시스템을 스캔하여 AI 도구, 지침 파일, 스킬 디렉토리를 찾습니다. |
manage report [--enhance] | 사용 통계 및 개선 팁을 제공합니다. |
manage init [--dry-run] | 대화형 설정: 스캔, 분류, 라우팅, 연결 (wire). |
manage security [scan] | SkillSpector 취약점 스캔을 수행합니다. |
manage create [name] | 마법사 (wizard)를 통해 새로운 스킬을 생성합니다. |
manage create from <file> | 기존 파일을 스킬로 변환합니다. |
manage uninstall | omni-skills 연결 (wiring)을 제거합니다. |
하위 호환성을 위해 기존의 최상위 명령 (예: omni-skills check)도 여전히 작동하지만, 새로운 스크립트에서는 omni-skills manage check를 사용하는 것이 권장됩니다.
상세한 사용법, 실제 통계, 상태 확인 (health checks), 검증 및 테스트는 docs/usage.md를 참조하세요.
기존 CLI에는 약 15개의 최상위 명령이 있었습니다. 이는 도구를 실제보다 무겁게 보이게 만들고 잘못된 명령을 실행할 가능성을 높였습니다. 리팩터링 (refactor)을 통해 일상적인 명령어 범위는 매우 작게 (sync, setup, doctor, restore) 유지하고, 그 외의 모든 기능은 manage 뒤로 이동시켰습니다. 목표는 **더 많은 기능이 아니라, 마찰을 줄이는 것 (less friction, not more features)**입니다.
omni-skills sync는 지침 파일 (instruction files), MCP 설정, 훅 (hooks) 및 스킬 디렉토리를 다시 작성할 수 있습니다. 무언가를 작성하기 전에, 현재 버전을 다음 경로로 복사합니다:
~/.config/skills/backups/<ISO-timestamp>/
만약 동기화 (sync) 과정에서 도구 설정이 깨지더라도, 해당 디렉토리에서 수동으로 복구할 수 있습니다. --dry-run (아무것도 변경되지 않음) 또는 --no-backup (사용자가 의도를 알고 있음) 옵션을 사용하면 백업을 건너뜁니다. 오래된 백업은 30일 후에 자동으로 정리됩니다.
여러 명령 (sync, setup, check, classify, init
여러 명령 (sync, setup, check, classify, init)은 무언가를 실제로 작성하기 전에 기본적으로 dry-run (실행 시뮬레이션) 미리보기를 수행합니다. 여러 명령을 연속해서 실행할 때 매번 다시 확인하는 것은 번거롭습니다. --yes 옵션은 해당 단일 호출에 대해서만 유지되기 때문에 위험할 수 있습니다. 대신 환경 변수 (environment variable)를 사용하세요:
export OMNI_SKILLS_SESSION_YES=1
omni-skills setup
omni-skills sync all
...
이 방식은 현재 셸 세션 (shell session) 동안에만 확인 절차를 건너뜁니다. 셸이 종료되면 재정의(override) 설정도 사라집니다.
Omni Skills는 사용자의 기술 (skills)을 한곳에 모아 관리하지만, 특정 작업에 어떤 AI 에이전트 (AI agent)를 사용할지는 알려주지 않습니다. 그 기능은 ai-tool-router를 참조하세요. 이는 설치된 에이전트들을 스캔하고, 비용과 강점을 기억하며, 가장 저렴하면서도 역량이 있는 도구(및 폴백 (fallback))를 제안하는 별도의 의존성 없는 (zero-dependency) 기술입니다.
- 설치 옵션 및 이유 (
brew tap) - 아키텍처 (Architecture): 컴파일러 (compiler), 실행 경계 (execution boundaries), MCP 서버 (MCP server)
- 워크플로우 (Workflows): 체이닝 가능한 기술 시퀀스 (chainable skill sequences)
- NVIDIA SkillSpector를 이용한 보안 스캐닝 (Security scanning)
- 새로운 기술 생성하기
- 기술 저장 방법
- 사용 가이드, 상태 확인 (health checks), 검증 (verification)
MIT — LICENSE 참조.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기