Orca 기술 레지스트리 및 MCP

npx skills add로 Orca 에이전트 스킬을 설치합니다. 하이브리드 스텁은 간결하게 유지되며 orca skills get은 버전에 맞는 가이드를 제공합니다. Orca는 백그라운드에서 스킬을 업데이트할 수 있습니다.

Orca에는 에이전트가 스킬 디렉터리에 설치하는 스킬이 포함되어 있습니다. 공개 설치 패키지는 하이브리드 검색 스텁입니다. 에이전트가 Orca을 사용해야 하는 시점과 실행 중인 CLI에서 전체 가이드를 불러오는 방법을 알려 주는 짧은 SKILL.md 파일입니다. 명령 플래그는 바이너리에 있으므로 앱 버전과 달라질 수 없습니다.

설치 가능한 Orca 스킬

공개 Orca 저장소 및 스킬 이름과 함께 npx skills add을 사용합니다. 기본 에이전트 설정은 일반적으로 orca-cli, computer-use, orchestration를 설치합니다.

스킬	설치	용도
orca-cli	npx skills add https://github.com/stablyai/orca --skill orca-cli --global	작업 트리, 터미널, 파일, 자동화, 내장 브라우저
orchestration	npx skills add https://github.com/stablyai/orca --skill orchestration --global	다중 에이전트 실행, 작업, 감독되는 워커, 메시지, 게이트
computer-use	npx skills add https://github.com/stablyai/orca --skill computer-use --global	접근성 트리와 안전한 UI 작업을 통한 데스크톱 앱 제어
orca-linear	npx skills add https://github.com/stablyai/orca --skill orca-linear --global	orca linear를 통한 Linear 티켓 read/write
orca-emulator	npx skills add https://github.com/stablyai/orca --skill orca-emulator --global	iOS Simulator 제어
orca-emulator-android	npx skills add https://github.com/stablyai/orca --skill orca-emulator-android --global	adb를 통한 Android emulator/device
orca-per-workspace-env	npx skills add https://github.com/stablyai/orca --skill orca-per-workspace-env --global	작업 공간별 환경 레시피(orca.yaml)

하이브리드 스텁과 실시간 가이드

npx skills add을 실행한 후 에이전트에는 다음 내용을 담은 짧은 스텁이 표시됩니다.

1. 이 세션의 CLI 실행 파일(ORCA_CLI_COMMAND, orca-dev, Linux의 orca-ide, 그 외에는 orca)을 확인합니다.
2. orca skills get <topic>로 전체 가이드를 불러옵니다. 긴 가이드에는 --full을 사용합니다.
3. --json을 우선 사용하고 기억에 의존하여 플래그를 만들어 내지 않습니다.

orca skills list
orca skills get orca-cli
orca skills get orchestration --full
orca skills get orca-linear --json

에이전트가 자동화에 사용할 결정적 출력이 필요하면 --json을 추가합니다. skills show는 skills get의 별칭입니다.

스킬을 최신 상태로 유지

Orca에 전역 설치 버전보다 최신 스킬 패키지가 포함되어 있으면 앱에서 다음 작업을 수행할 수 있습니다.

• Update available(업데이트 사용 가능) 알림을 표시합니다. 업데이터가 안전하게 다시 쓸 수 없는 위치의 복사본이 오래된 경우 **Needs attention(확인 필요)**도 표시합니다.
• **Update skills(스킬 업데이트)**를 열어 설치 위치와 건너뛴 이유를 확인한 다음, **npx --yes skills update <names> --global -y**을 헤드리스로 실행합니다. 내장 터미널은 사용하지 않습니다.
• 실행은 백그라운드에서 계속됩니다. 대화 상자를 닫아도 취소되지 않습니다. 상태 표시줄 영역에는 진행 상태가 표시됩니다. 실행 중에는 스피너, 성공 직후에는 잠시 확인 표시, 조치 전까지는 지속적인 실패 상태가 표시됩니다. 이 영역을 클릭하면 대화 상자가 다시 열립니다.
• 설치된 스킬의 최신 상태를 **Settings → Agents(설정 → 에이전트)**에 표시합니다. 스킬 행을 검토해야 하는 경우 **Details(세부 정보)**도 표시됩니다.

수동으로 실행하는 동등한 명령은 다음과 같습니다. 데스크톱 Settings(설정)에도 동일한 npx 형식이 표시됩니다.

npx skills update orca-cli orchestration computer-use --global

Settings(설정) UI가 없는 헤드리스 호스트(SSH, 컨테이너, CI, orca serve)에서는 로컬 CLI 래퍼를 사용합니다. 이 래퍼는 동일한 npx 명령을 확인하고 비대화형 플래그를 추가하며, 실행 중인 Orca 런타임이 필요하지 않습니다.

orca skills install                                      # list installable names
orca skills install --skill orca-cli --skill orchestration
orca skills install --skill orca-cli --agent claude-code,codex
orca skills install --all --dry-run
orca skills update --all
orca skills update --skill orca-cli --dry-run

• 기본 범위는 전역(--global)입니다. 현재 프로젝트에만 적용하려면 --local를 전달합니다.
• install은 Orca이 호스트에서 감지한 에이전트와 공유 .agents/skills 디렉터리를 대상으로 합니다. 대상 에이전트를 지정하려면 --agent <name>[,<name>…] 또는 --agent universal을 사용합니다. 감지된 에이전트가 없으면 --agent가 필요합니다.
• update는 이미 설치된 스킬만 새로 고칩니다.
• --dry-run은 확인된 명령을 출력합니다. --json은 목록 표시 또는 --dry-run와 함께 사용할 때만 유효합니다.

Orca이 앱 내 업데이터를 제공하면 앱에서 검사한 동일한 전역 설치 위치가 다시 작성되도록 이 업데이터를 사용하는 것이 좋습니다. **Skipped(건너뜀)**로 표시된 행에는 해당 스킬을 자동으로 업데이트할 수 없는 이유(예: 소스 등록 누락)가 설명되어 있습니다. 설치 위치를 수정한 뒤 다시 확인합니다.

Skills(스킬) 페이지에서 설치 및 삭제

앱 내 설치에서 작업 공간 대상을 요청하면 작업 공간 이름이나 종류(worktree(작업 트리) / folder(폴더))로 선택기를 검색합니다. 에이전트 선택기는 Orca가 항상 포함하는 디렉터리와 선택할 수 있는 추가 에이전트 디렉터리를 구분하므로, 계속하기 전에 정확한 설치 대상을 검토할 수 있습니다.

검색된 스킬을 제거하려면 작업 메뉴를 열고 **Delete…(삭제…)**를 선택합니다. 여러 스킬을 제거하려면 페이지의 More actions(추가 작업) 메뉴를 열고 **Delete skills…(스킬 삭제…)**를 선택한 다음 삭제할 수 있는 결과를 선택합니다. Orca는 확인 전에 번들에 포함되었거나, 플러그인에서 관리되거나, 읽기 전용이거나, 제거 가능한 스킬 폴더 밖에 있는 등의 이유로 복사본을 삭제할 수 없는 이유를 설명합니다. 이는 공유 링크로 설치된 복사본을 관리하는 **Manage installs(설치 관리)**와 별개입니다.

호스트 간에 비공개 스킬 공유

**Skills → Share skills(스킬 → 스킬 공유)**을 열어 하나의 스킬 또는 번들을 검색 목록에 표시되지 않고 취소 가능한 링크 하나로 게시합니다. 게시하려면 Orca 계정이 필요합니다. 게시하기 전에 포함된 파일, 스크립트, 실행 파일, 다이제스트 및 선택적 릴리스 정보를 검토합니다. 게시된 각 버전은 변경할 수 없으므로 이후의 로컬 편집 내용이 수신자가 설치하는 항목을 예고 없이 변경하지 않습니다.

활성 링크가 있는 사람은 누구나 로그인하지 않고 공유된 스킬을 검사하고 설치할 수 있으므로 링크를 자격 증명처럼 취급합니다. 수신자는 정확한 버전을 검토하고 스킬 전체 또는 일부를 선택한 다음 이 컴퓨터, 페어링된 Orca 런타임, WSL 또는 SSH 호스트에서 전역 범위나 작업 공간 범위를 선택합니다. 이미 수정된 스킬의 기본값은 **Keep local(로컬 유지)**입니다. **Skills → Manage installs(스킬 → 설치 관리)**에서 Orca가 설치한 복사본을 업데이트, 롤백 또는 제거하고, **Settings → Share Skills(설정 → 스킬 공유)**에서 활성 링크를 복사하거나 취소합니다. 링크를 취소하면 이후 접근은 차단되지만 이미 설치된 복사본은 제거되지 않습니다.

별도로 제공되며 기본적으로 꺼져 있는 Settings → Share Skills → Allow agents and the Orca CLI to publish skill links(설정 → 스킬 공유 → 에이전트 및 CLI의 스킬 링크 게시 허용) 권한을 활성화하면 에이전트가 CLI에서 명시적으로 이름을 지정한 집합을 게시할 수 있습니다:

orca skills installed --json
orca skills share --skill frontend --skill testing --bundle-name "Team Toolkit" --json

skills installed는 로컬 경로를 노출하지 않는 안전한 선택자를 반환합니다. skills share는 정확한 검색 ID 또는 모호하지 않은 이름을 허용하며, 임의의 경로나 --all은 허용하지 않습니다.

orca-cli

npx skills add https://github.com/stablyai/orca --skill orca-cli --global

설치 후 orca skills get orca-cli로 버전에 맞는 명령 가이드를 불러옵니다. Orca CLI를 참조합니다.

오케스트레이션

npx skills add https://github.com/stablyai/orca --skill orchestration --global

에이전트가 실행, 작업, 감독되는 워커 및 결정 게이트를 통해 다른 에이전트를 조정해야 할 때 사용합니다. 오케스트레이션을 참조합니다. 오케스트레이션 상태를 변경하기 전에 항상 orca skills get orchestration --full를 불러옵니다. 이전 orchestration run 명령은 사용 중단되었습니다.

컴퓨터 사용

npx skills add https://github.com/stablyai/orca --skill computer-use --global

에이전트가 로컬 데스크톱 앱 창을 검사하고 조작해야 할 때 사용합니다. 컴퓨터 사용을 참조합니다.

orca-linear 스킬

npx skills add https://github.com/stablyai/orca --skill orca-linear --global

에이전트는 티켓을 변경하기 전에 orca skills get orca-linear을 불러와야 합니다. issue --full, save-issue, list-issues, 관계, 완료 시 첨부+댓글 흐름 및 신뢰할 수 없는 티켓 규칙을 다룹니다. 기존 linear-tickets 설치도 계속 확인됩니다. CLI 참조 → Linear을 참조합니다.

orca-emulator 스킬

npx skills add https://github.com/stablyai/orca --skill orca-emulator --global

에이전트가 orca emulator 명령을 통해 Orca 내부에서 iOS 시뮬레이터를 제어해야 하는 경우 이 기능을 사용하세요.

orca-emulator-android 사용

npx skills add https://github.com/stablyai/orca --skill orca-emulator-android --global

adb로 연결된 Android AVDs/devices에서 list/boot, tap/swipe/type, 하드웨어 버튼, install/launch, 권한, 접근성 트리 및 logcat을 사용할 때 적용합니다. orca skills get orca-emulator-android로 세부 정보를 불러옵니다.

orca-per-workspace-env 사용

npx skills add https://github.com/stablyai/orca --skill orca-per-workspace-env --global

orca.yaml에서 작업 공간별 환경 레시피를 설정하거나 디버그할 때 사용합니다. Orca 실행 방식을 참조합니다.

검색 소스

Orca의 스킬 UI는 Claude, Codex, Agent Skills 및 OMP(~/.omp/agent/skills)의 설치된 스킬 홈을 검사하므로 해당 위치에 배치된 스킬은 수동 심볼릭 링크 없이 표시됩니다.

나만의 스킬 추가

skills/<name>/SKILL.md 파일이 있는 모든 저장소는 npx skills add를 통해 설치할 수 있습니다. 에이전트에게 내부 저장소를 지정하여 회사별 권한을 부여하세요.

MCP 서버

MCP(모델 컨텍스트 프로토콜) 서버는 외부 도구를 호환 가능한 에이전트에 노출합니다. 설정 → 통합 → MCP에서 MCP 엔드포인트를 등록합니다. 이러한 도구는 MCP를 지원하는 에이전트 CLI 내부에 나타납니다.