alpha-nerd/opencode-for-legal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Fix install docs: opencode auto-discovers skills, no skills.paths config

Browse source
This commit is contained in:
Alpha Nerd 2026-06-13 15:38:30 +02:00
parent 27fbe1f313
commit 5cf3779f8a
Signed by: alpha-nerd
SSH key fingerprint: SHA256:QkkAgVoYi9TQ0UKPkiKSfnerZy2h4qhi3SVPXJmBN+M
2 changed files with 41 additions and 42 deletions
Download patch file Download diff file Expand all files Collapse all files

55
INSTALL.md
View file

@ -4,35 +4,35 @@
## Quick Install
### Option A: Local (recommended)
### Local (recommended)
Opencode auto-discovers skills from `~/.config/opencode/skills/` and agents from `.opencode/agents/` — no config changes needed.
```bash
# Clone the repo
git clone <repo-url> /tmp/opencode-for-legal
# Copy skills to your opencode skills directory
cp -r /tmp/opencode-for-legal/opencode-for-legal/skills/* ~/.config/opencode/skills/
# Copy agents to your opencode agents directory
mkdir -p ~/.opencode/agents
cp /tmp/opencode-for-legal/opencode-for-legal/agents/* ~/.opencode/agents/
```
### Symlink alternative
If you prefer to keep the repo in one place and sync updates:
```bash
# Clone the repo
git clone <repo-url> ~/legal-tools
# Add skills path to your opencode config
# ~/.config/opencode/opencode.json:
{
"skills": {
"paths": ["~/legal-tools/opencode-for-legal/skills"]
}
}
# Symlink individual skills (avoids name conflicts)
ln -s ~/legal-tools/opencode-for-legal/skills/* ~/.config/opencode/skills/
ln -s ~/legal-tools/opencode-for-legal/agents/* ~/.opencode/agents/
```
### Option B: Remote catalog
If the repo is hosted at a URL that serves `index.json`:
```json
{
"skills": {
"urls": ["https://<your-host>/index.json"]
}
}
```
Opencode downloads and caches skills automatically.
## Setup
After install, run the setup wizard:
@ -47,9 +47,15 @@ This guides you through:
3. Replacing `[PLACEHOLDER]` values with your company's configuration
4. Enabling the MCP servers you have access to
**Note:** The setup skill copies templates from `opencode-for-legal/legal-config/` (the repo). Make sure that directory is accessible, or copy the templates manually:
```bash
mkdir -p ~/.config/opencode/opencode-for-legal
cp /tmp/opencode-for-legal/opencode-for-legal/legal-config/* ~/.config/opencode/opencode-for-legal/
```
## MCP Servers
Copy `opencode-for-legal/opencode.json.example` to `~/.config/opencode/opencode.json`, then uncomment and configure only the servers you use:
Copy `opencode-for-legal/opencode.json.example` to `~/.config/opencode/opencode.json`, then uncomment and configure only the servers you use. Or merge the `mcp` block into your existing config.
```json
{
@ -313,7 +319,8 @@ Each plugin has a practice-profile template in `opencode-for-legal/legal-config/
## Differences from Opencode Version
- **No plugin manifests** — Opencode discovers skills by directory structure
- **No plugin manifests** — Opencode auto-discovers skills from `~/.config/opencode/skills/`
- **No `skills.paths` config** — copy or symlink skills directly to `~/.config/opencode/skills/`
- **Skill names are namespaced** — `{plugin}-{skill}` instead of `/plugin:skill`
- **MCP config is in opencode.json** — not per-plugin `.mcp.json` files
- **No hooks** — Opencode's `hooks.json` was empty stubs; Opencode hooks require TypeScript plugins

28
README.md
View file

@ -11,26 +11,18 @@
## Quick Install
```bash
# Local install
git clone <repo-url> ~/.config/opencode/opencode-for-legal
# Clone the repo
git clone <repo-url> /tmp/opencode-for-legal
# Add to opencode.json:
{
"skills": {
"paths": ["~/.config/opencode/opencode-for-legal/skills"]
}
}
# Copy skills to your opencode skills directory
cp -r /tmp/opencode-for-legal/opencode-for-legal/skills/* ~/.config/opencode/skills/
# Copy agents to your opencode agents directory
mkdir -p ~/.opencode/agents
cp /tmp/opencode-for-legal/opencode-for-legal/agents/* ~/.opencode/agents/
```
Or use the remote catalog:
```json
{
"skills": {
"urls": ["https://<your-host>/index.json"]
}
}
```
Opencode auto-discovers skills from `~/.config/opencode/skills/` and agents from `.opencode/agents/` — no config changes needed.
See [INSTALL.md](INSTALL.md) for full setup instructions.
@ -123,7 +115,7 @@ Each plugin has a practice-profile template in `opencode-for-legal/legal-config/
| Aspect | Original (Claude Code) | This Port (Opencode) |
|---|---|---|
| **Distribution** | Claude Code plugin marketplace | Opencode skills (local or remote catalog) |
| **Distribution** | Claude Code plugin marketplace | Copy to `~/.config/opencode/skills/` (auto-discovered) |
| **Skill invocation** | `/plugin:skill` slash commands | Auto-loaded by model from `skills/` directory |
| **Skill naming** | Short names within plugin namespace | Namespaced: `{plugin}-{skill}` (e.g., `commercial-legal-nda-review`) |
| **MCP config** | Per-plugin `.mcp.json` files | Single `opencode.json` with `mcp` key |