2026-07-21 21:09:07 +00:00
|
|
|
# OpenCode Integration
|
|
|
|
|
|
2026-08-28 03:24:54 +00:00
|
|
|
[OpenCode](https://opencode.ai/) discovers provider-neutral skills
|
|
|
|
|
directly from `.agents/skills/` and pre-migration piker skills from
|
|
|
|
|
`.claude/skills/`. There is no second copy of each skill to keep in
|
|
|
|
|
sync.
|
2026-07-21 21:09:07 +00:00
|
|
|
|
|
|
|
|
## Available Skills
|
|
|
|
|
|
|
|
|
|
| Skill | Activation | Specialization |
|
|
|
|
|
|-------|------------|----------------|
|
|
|
|
|
| `commit-msg` | `/commit-msg` or explicit request | Piker commit-message style and artifacts |
|
2026-08-28 03:24:54 +00:00
|
|
|
| `piker-clearing-expert` | automatic | Clearing, order-control, and accounting invariants |
|
2026-07-21 21:09:07 +00:00
|
|
|
| `piker-conc-expert` | automatic | `tractor` actor topology, RPC, and cancellation |
|
|
|
|
|
| `piker-profiling` | automatic | Cross-actor `Profiler` instrumentation |
|
|
|
|
|
| `piker-slang` | automatic | Project communication style |
|
|
|
|
|
| `py-codestyle` | automatic | Python source conventions |
|
|
|
|
|
| `pyqtgraph-optimization` | automatic | Batched Qt graphics rendering |
|
|
|
|
|
| `timeseries-optimization` | automatic | NumPy and Polars timeseries performance |
|
|
|
|
|
|
|
|
|
|
OpenCode's project command lives at
|
|
|
|
|
`.opencode/commands/commit-msg.md`. It delegates to the
|
|
|
|
|
shared `commit-msg` skill and only supplies command
|
|
|
|
|
arguments; workflow logic remains in the skill.
|
|
|
|
|
|
|
|
|
|
A user-local skill with the same name may override a repo
|
|
|
|
|
skill. Treat `opencode debug skill` as authoritative when
|
|
|
|
|
diagnosing which source is active.
|
|
|
|
|
|
|
|
|
|
## Verify Discovery
|
|
|
|
|
|
|
|
|
|
From the repository root:
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
opencode debug skill
|
|
|
|
|
opencode debug config
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
`opencode debug skill` should list the piker skills from
|
|
|
|
|
the project checkout. Restart OpenCode after changing a
|
|
|
|
|
skill or command because configuration-time files are not
|
|
|
|
|
hot-reloaded into an active session.
|
|
|
|
|
|
|
|
|
|
## Portability Rules
|
|
|
|
|
|
|
|
|
|
- Use only portable Agent Skills frontmatter in shared
|
|
|
|
|
`SKILL.md` files.
|
|
|
|
|
- Keep harness-specific command syntax under
|
|
|
|
|
`.opencode/commands/`.
|
|
|
|
|
- Detect the active harness and model at runtime; do not
|
|
|
|
|
hardcode Claude Code attribution in shared workflows.
|
|
|
|
|
- Keep supporting references beside each shared skill so
|
|
|
|
|
relative links resolve in every harness.
|
2026-08-28 03:24:54 +00:00
|
|
|
- Put new provider-neutral bundles under `.agents/skills/`; use
|
|
|
|
|
relative provider links only when a harness requires one.
|
