Files

Harry Bayliss c113d7ecbd Add OpenCode skills

2026-04-29 21:25:39 +01:00

name, description, compatibility

name	description	compatibility
counselors	Run multi-agent code reviews with the counselors CLI and synthesize actionable findings.	opencode

Counselors Skill

Use this skill when the user asks for second opinions, multi-model review, architecture critique, or bug/risk hunting.

Core workflow

Gather context quickly.
- Identify the target files and question scope.
- If needed, inspect git diff HEAD and git diff --staged.
Discover configured tools and groups.
- Run:
  - counselors ls
  - counselors groups ls
- Show the full outputs to the user and ask which tools/group to use.
Build prompt file with counselors.
- Use counselors mkdir --json and pipe prompt content in.
- Use @path/to/file references instead of inlining large files.
Dispatch run.
- Single pass: counselors run -f <promptFilePath> --tools <ids> --read-only best-effort --json
- Iterative pass: counselors loop -f <promptFilePath> --tools <ids> --read-only best-effort --json
- Preset loop: counselors loop --preset <preset> "<focus>" --tools <ids> --read-only best-effort --json
Read outputs and synthesize.
- Parse the JSON manifest.
- Read each outputFile for successful tools.
- Check stderrFile for failed/empty tools.
- Produce concise synthesis:
  - consensus
  - disagreements
  - key risks
  - recommendation
- Include the saved output directory path.

Ask for tool/group selection before dispatch.
Confirm final tool list before running.
Prefer --json output for parseability.
Use long timeouts for dispatch (often 10+ minutes).
If selected tools include custom opencode-*, avoid --read-only strict because those tools are configured as bestEffort and will be skipped under strict policy.
If no tools are configured, instruct user to run counselors init --auto.