feat: add orcarouter cross-model review skill - #114
Open
XiaoHuo888-hue wants to merge 1 commit into
Open
Conversation
Adds a host-agnostic orcarouter skill that routes a second opinion through OrcaRouter, one OpenAI-compatible endpoint and API key, with the orcarouter/auto smart router picking the best upstream model per request. Mirrors the existing gemini skill with review, challenge, and consult modes for code, Google Ads, and SEO changes, and honors an optional ORCAROUTER_MODEL override. Registered in .claude-plugin/plugin.json, skills/ Codex wrappers, AGENTS.md, README.md, INSTALL_FOR_AGENTS.md, and CHANGELOG.md; bumps all manifests to 0.28.0. Co-Authored-By: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This registers OrcaRouter the same way the existing
geminiskill is wired, so the cross-model review catalog, resolver and install docs stay consistent. OrcaRouter is an OpenAI-compatible gateway: oneORCAROUTER_API_KEY(keys start withsk-orca-) unlocks 150+ models from OpenAI, Anthropic, Google, DeepSeek, Qwen, MiniMax and xAI behind a singlehttps://api.orcarouter.ai/v1endpoint. It also runs gateway-level, zero-trust security for AI agents on the same endpoint - screening every prompt/response and governing every tool call on a default-deny basis, with no application code changes.I'm an engineer on the OrcaRouter team.
What this changes
orcarouter/SKILL.md: new canonical skill mirroringgemini/SKILL.mdwith review, challenge, and consult modes for code, Google Ads, and SEO changes. It calls OrcaRouter with curl, so no per-vendor CLI install is needed. It defaults to theorcarouter/autosmart router and honors an optionalORCAROUTER_MODELoverride to pin a specific model.skills/orcarouter/SKILL.md: Codex wrapper that forwards to the canonical skill, keeping frontmatter in parity..claude-plugin/plugin.json: registers./orcarouterin the skills array, bumps version to 0.28.0..claude-plugin/marketplace.json,.codex-plugin/plugin.json,VERSION: version bumped to 0.28.0 in lockstep.AGENTS.md: adds theorcarouterrow to the Cross-model review table and documents the API key dependency.README.md: adds the skill to the cross-model review catalog, the integrations table, and the repo tree; updates the skill count to 46.INSTALL_FOR_AGENTS.md: documents theORCAROUTER_API_KEYrequirement.CHANGELOG.md: adds the v0.28.0 entry under Unreleased.Why a separate skill rather than reusing the Gemini path
The
geminiskill requiresnpm install -g @google/gemini-cliplus a one-time Google authentication. OrcaRouter is OpenAI-compatible and needs only an API key, so it works in hosts where installing a Gemini CLI is not an option. Its defaultorcarouter/autorouter picks the best upstream model per request, which yields a genuinely independent second opinion from a different model family than the one doing the work.How to use it
sk-orca-).ORCAROUTER_API_KEY./notfair:orcarouter review(orchallenge/consult), optionally pinning a model viaORCAROUTER_MODELsuch asopenai/gpt-5.5oranthropic/claude-sonnet-4.6.Verification
python3 -m pytest test/unit/- 270 passed.python3 -m pytest -q- 270 passed, 14 skipped, 8 subtests passed.test_mcp_skill_e2e.py): 46 Codex wrappers match the 46 registered skills, and theorcaroutercanonical/wrapper frontmatter are byte-identical.plugin.json,marketplace.json(both fields),.codex-plugin/plugin.json, andVERSION.POST https://api.orcarouter.ai/v1/chat/completionswithorcarouter/autoreturned HTTP 200 (routed togemini-3.1-flash-lite) and produced the full structured review. Pinningopenai/gpt-5.5also returned HTTP 200.Note:
test_mcp_skill_e2e.py::test_universal_mcp_is_the_only_registered_server_and_skills_use_platform_prefixescurrently fails onmainas well: thebroken-link-checkercanonical frontmatter has a trailing space that its Codex wrapper lacks, so the byte-identical frontmatter assertion trips. This PR does not touch that skill; I can open a follow-up one-character fix if helpful.