skills/docs/skill-compatibility.md
dan 1e1965dc17 docs: add worklogs and work documents from Jan 21 sessions
- 2026-01-21-add-review-skills.md
- 2026-01-21-ralph-wiggum-lan-web-ui-prototype.md
- 2026-01-21-worker-rpc-web-skills-audit.md
- skill-compatibility.md
- lan-web-ui-prototype work doc
2026-01-24 09:40:38 -08:00

2.4 KiB

Skill Compatibility Audit (Top 10)

Status legend:

  • Works as-is
  • ⚠️ Works with prerequisites / setup
  • Not supported

Agents:

  • Claude Code
  • Gemini CLI
  • Codex
  • OpenCode
  • Pi

Summary Table

Skill Key Dependencies Claude Gemini Codex OpenCode Pi Notes
hq worker, bd, git ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Requires worker/bd installed; worker launch uses agent-specific CLI.
review-gate review-gate, jq ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Claude supports Stop hook; others need manual orchestration.
orch orch + API keys ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Requires orch CLI + GEMINI/OPENAI/OPENROUTER keys.
code-review bd, lenses in ~/.config/lenses/code/ ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Works if bd + lenses are installed; optional orch.
ops-review bd, jq, shellcheck/statix/deadnix/hadolint/yamllint ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Heavy toolchain; works with shell access + deps.
spec-review orch + API keys ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Requires orch CLI; spec-kit repo structure.
web-search claude CLI ⚠️ Claude-only unless claude CLI installed.
web-research claude CLI (+ optional llm, kagi) ⚠️ Claude-only unless claude CLI installed.
brave-search Node 18+, npm install, BRAVE_API_KEY ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Portable but requires Node + Brave API key.
playwright-visit Playwright + Chromium (Nix devshell) ⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Works with shell + devshell setup; used for QA.

Key Gaps

  1. Claude-dependent web search: web-search and web-research require Claude CLI and will fail for Gemini/Codex/OpenCode by default.
  2. Toolchain-heavy reviews: ops-review and code-review depend on local tool installs and lens files.
  3. Worker orchestration relies on bd: hq and review-gate depend on bd and worker being present.

Immediate Opportunities

  • Encourage brave-search as the default fallback when Claude search is unavailable.
  • Add dependency checks and clearer failure messaging in web-search / web-research scripts.
  • Document minimal install steps for review skills (lenses + lint toolchain).