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

42 lines
2.4 KiB
Markdown

# 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).