pikers
/
piker
4
1
Fork 0
Code Issues 20 Pull Requests 11 Packages Projects Releases Wiki Activity
piker/ai/opencode
History
Gud Boi c6ec3d4144 Share piker skills across coding harnesses 
Use portable Agent Skills metadata and one repo-local source for
both Claude Code and OpenCode.

Deats,
- replace harness-only frontmatter and dynamic context
- make `commit-msg` runtime-aware and review-first
- add a thin OpenCode command and integration docs
- guard `np.searchsorted()` guidance before OOB indexing
- record OpenCode prompt provenance

Prompt-IO: ai/prompt-io/opencode/20260721T205228Z_58ffe487_prompt_io.md

(this patch was generated in some part by `opencode` using `gpt-5.6-sol` (`openai`))
 		2026-07-21 17:09:07 -04:00
..
README.md Share piker skills across coding harnesses 2026-07-21 17:09:07 -04:00

README.md

OpenCode Integration

OpenCode uses piker’s shared repo-specific skills directly 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-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.