skill-inject 0.9.0

skill-inject: local semantic auto-injection of agent skills
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# skill-inject — opencode adapter

The opencode twin of the Claude hooks adapter. It bridges opencode plugin events
to the `ski` binary so the right skill is embedded, ranked, and injected locally
on every prompt — no cloud decision, no tool-call round trip.

`ski.ts` is a thin bridge; all ranking, injection text, and session bookkeeping
live in the Rust binary. It fails open: if `ski` is missing or errors, the plugin
does nothing.

## What it wires

| opencode hook                          | ski command                         | purpose                                                          |
| -------------------------------------- | ----------------------------------- | --------------------------------------------------------------- |
| `chat.message`                         | `ski hook --host opencode`          | rank the prompt; stash the matching directive for the turn      |
| `experimental.chat.system.transform`   | —                                   | inject the stashed directive into the **system prompt**         |
| `tool.execute.after`                   | `ski observe --host opencode`       | record skills the model loaded itself (Read of SKILL.md, etc.)  |
| `event` (`session.compacted`)          | `ski session-start --host opencode` | clear the loaded-ledger so skills re-inject after compaction    |
| plugin load                            | `ski session-start --host opencode` | incremental reindex (picks up new / edited skills)              |

The directive is injected as **additional context** through the system prompt,
not as a message part — it must read as injected guidance, never as text the user
typed. `chat.message` (which sees the prompt) and `experimental.chat.system.transform`
(which sees the system prompt) hand off through an in-memory per-session stash.

The hook resolves `ski` from `PATH`, then `~/.local/bin`, then `~/.cargo/bin` —
the same order as the Claude adapter's `ski-bootstrap.sh`.

## Install

The repo's `scripts/install.sh` (the `curl … | sh` one-liner in the
[top-level README](../README.md#install)) installs the binary and wires opencode
automatically when `~/.config/opencode` is present.

To set up opencode from an already-installed binary, run:

```bash
ski init -g opencode
```

It writes the bundled plugin to `~/.config/opencode/plugin/ski.ts`, where opencode
auto-loads it. Building the binary from source first: `cargo install --path <repo>`
(add `--no-default-features` for the offline bag-of-words lane).

## Skill roots

`ski` reads opencode skills from `~/.config/opencode/skills` (plus the shared
roots). Override with `SKI_ROOTS` (colon-separated).