pikers
/
piker
4
1
Fork 0
Code Issues 20 Pull Requests 13 Packages Projects Releases Wiki Activity
piker/ai/opencode
History
Gud Boi 1606122b45 Add `piker-clearing-expert` skill 
Capture EMS/order-control ownership, identifier boundaries, ledger
and position invariants, backend variation, and current known hazards.

Store the canonical bundle under `.agents/skills/` and bridge Claude
discovery through a portable relative link.

Also,
- add architecture, debugging, and test-map references;
- document the provider-neutral source convention;
- ignore the canonical `wkts/` runtime root.

Prompt-IO: ai/prompt-io/opencode/20260828T021411Z_6ca6ab2a_prompt_io.md

(this patch was generated in some part by `opencode` using `gpt-5.6-sol` (`openai`))
 		2026-08-27 23:24:54 -04:00
..
README.md Add `piker-clearing-expert` skill 2026-08-27 23:24:54 -04:00

README.md

OpenCode Integration

OpenCode 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.

Available Skills

Skill Activation Specialization
commit-msg /commit-msg or explicit request Piker commit-message style and artifacts
piker-clearing-expert automatic Clearing, order-control, and accounting invariants
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:

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.
  • Put new provider-neutral bundles under .agents/skills/; use relative provider links only when a harness requires one.