Orca skills registry & MCP

Cài skill agent Orca bằng npx skills add. Stub hybrid gọn nhẹ; orca skills get phục vụ guide khớp đúng phiên bản. Orca có thể cập nhật skill ở nền.

Orca đi kèm các skill mà agent cài vào thư mục skill của chúng. Gói cài công khai là stub discovery hybrid: các file SKILL.md ngắn báo cho agent biết khi nào nên dùng Orca và cách nạp guide đầy đủ từ CLI đang chạy. Flag lệnh nằm trong binary nên không thể lệch khỏi phiên bản app.

Skill Orca có thể cài

Dùng npx skills add với repo Orca công khai và tên skill. Setup agent mặc định thường cài orca-cli, computer-use, và orchestration.

Skill	Cài	Dùng cho
orca-cli	npx skills add https://github.com/stablyai/orca --skill orca-cli --global	Worktree, terminal, file, automation, trình duyệt nhúng.
orchestration	npx skills add https://github.com/stablyai/orca --skill orchestration --global	Run đa agent, task, worker giám sát, message, gate.
computer-use	npx skills add https://github.com/stablyai/orca --skill computer-use --global	App desktop qua accessibility tree và hành động UI an toàn.
orca-linear	npx skills add https://github.com/stablyai/orca --skill orca-linear --global	Đọc/ghi ticket Linear qua orca linear.
orca-emulator	npx skills add https://github.com/stablyai/orca --skill orca-emulator --global	Điều khiển iOS Simulator.
orca-emulator-android	npx skills add https://github.com/stablyai/orca --skill orca-emulator-android --global	Emulator/thiết bị Android qua adb.
orca-per-workspace-env	npx skills add https://github.com/stablyai/orca --skill orca-per-workspace-env --global	Recipe môi trường theo từng workspace (orca.yaml).

Stub hybrid so với guide sống

Sau npx skills add, agent thấy một stub ngắn nói rằng:

• Resolve executable CLI cho session này (ORCA_CLI_COMMAND, orca-dev, orca-ide trên Linux, còn lại là orca).
• Nạp guide đầy đủ: orca skills get <topic> (hoặc --full cho guide dài).
• Ưu tiên --json và đừng tự bịa flag từ trí nhớ.

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

Thêm --json khi agent cần output xác định (deterministic) cho automation. skills show là alias của skills get.

Giữ skill luôn cập nhật

Khi Orca ship một gói skill mới hơn bản đã cài toàn cục, app có thể:

• Hiện một nhắc update available (và Needs attention khi một bản copy đã cũ ở nơi updater không thể ghi đè an toàn).
• Mở Update skills - danh sách vị trí đã cài và lý do bị skip, rồi chạy npx --yes skills update <names> --global -y ở chế độ headless (không có terminal nhúng).
• Giữ lần chạy đó ở nền: đóng dialog không hủy nó. Một đoạn trên status bar hiện tiến độ (spinner khi đang chạy, dấu tick thành công ngắn, lỗi vẫn hiện cho tới khi bạn xử lý). Click vào đoạn đó để mở lại dialog.
• Hiện độ mới trên Settings → Agents cho skill đã cài (rail cài đặt toàn cục), gồm cả Details khi một dòng cần review.

Tương đương thủ công (Settings desktop vẫn hiện cùng form npx):

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

Trên host headless (SSH, container, CI, orca serve) không có Settings UI, dùng CLI wrapper local - chúng resolve cùng lệnh npx, thêm flag non-interactive, và không cần một runtime Orca đang chạy:

orca skills install # liệt kê tên có thể cài
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

• Phạm vi mặc định là global (--global); truyền --local để chỉ áp dụng cho project hiện tại.
• install nhắm tới agent Orca phát hiện được trên host (cộng thêm thư mục .agents/skills dùng chung). Dùng --agent <name>[,<name>…] hoặc --agent universal để override; nếu không phát hiện agent nào, --agent là bắt buộc.
• update chỉ refresh những skill đã cài sẵn.
• --dry-run in ra lệnh đã resolve; --json chỉ hợp lệ với listing / --dry-run.

Ưu tiên updater trong app khi Orca đưa ra tùy chọn đó, để đúng các vị trí global mà app đã quét được ghi đè lại. Dòng đánh dấu Skipped giải thích vì sao skill đó không tự update được (ví dụ thiếu đăng ký nguồn) - sửa vị trí đó, rồi kiểm tra lại.

orca-cli

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

Sau khi cài, nạp guide lệnh khớp phiên bản bằng orca skills get orca-cli. Xem Orca CLI.

orchestration

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

Dùng khi một agent nên điều phối các agent khác qua Run, task, worker giám sát, và decision gate. Xem Orchestration. Luôn nạp orca skills get orchestration --full trước khi thay đổi state orchestration - lệnh orchestration run cũ đã bị gỡ.

computer-use

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

Dùng khi một agent cần kiểm tra và điều khiển cửa sổ app desktop local. Xem Computer use.

orca-linear

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

Agent nên nạp orca skills get orca-linear trước khi sửa ticket. Gồm issue --full, save-issue, list-issues, relation, luồng attach+comment khi hoàn thành, và quy tắc với ticket không tin cậy. Bản cài linear-tickets cũ vẫn resolve được. Xem CLI reference → Linear.

orca-emulator

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

Dùng khi một agent nên điều khiển một iOS Simulator từ bên trong Orca qua lệnh orca emulator.

orca-emulator-android

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

Dùng cho AVD/thiết bị Android kết nối qua adb: list/boot, tap/swipe/type, phím cứng, install/launch, quyền, accessibility tree, logcat. Nạp chi tiết bằng orca skills get orca-emulator-android.

orca-per-workspace-env

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

Dùng khi thiết lập hoặc debug recipe môi trường theo từng workspace trong orca.yaml. Xem Các cách chạy Orca.

Nguồn phát hiện

UI skill của Orca quét các home skill đã cài cho Claude, Codex, Agent Skills, và OMP (~/.omp/agent/skills), nên skill đặt ở đó hiện ra mà không cần symlink thủ công.

Thêm skill của riêng bạn

Bất kỳ repo nào có file skills/<name>/SKILL.md đều cài được qua npx skills add. Trỏ agent của bạn vào các repo nội bộ để cấp cho nó năng lực riêng của công ty.

MCP server

Server Model Context Protocol (MCP) expose tool bên ngoài cho các agent tương thích. Đăng ký endpoint MCP ở Settings → Integrations → MCP; các tool đó xuất hiện bên trong CLI agent nào hỗ trợ MCP.

Nguồn

Dịch và biên soạn từ trang Orca skills registry & MCP trong tài liệu chính thức của Orca ADE (onorca.dev).