slopdocsOpenCode plugin and agent skill for the slopdocs documentation convention.
0
12
3 in 7 days
21.5
Multi-signal model
3 months ago
2026-05-09
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["slopdocs@1.0.1"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["slopdocs@1.0.1"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D slopdocsopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
An agent skill for the slopdocs convention. Teaches your coding agent to keep its planning docs, bug investigations, and feature write-ups in your repo where the next agent can find them.
Install (OpenCode)
Add to your opencode.json:
{
"plugin": ["slopdocs"]
}
Restart OpenCode. The slopdocs skill is now available and will be loaded automatically when the agent is writing or deciding whether to create documentation.
To track an unreleased version directly from the repo, install from git instead:
{
"plugin": ["slopdocs@git+https://github.com/ryanskidmore/slopdocs.git"]
}
Manual install
Copy skills/slopdocs/SKILL.md into your project:
.opencode/skills/slopdocs/SKILL.md
Or for cross-tool compatibility:
.agents/skills/slopdocs/SKILL.md
What it does
The skill teaches your agent the slopdocs convention:
slopdocs/features/- one living doc per featureslopdocs/bugs/- date-prefixed bug investigationsslopdocs/plans/- date-prefixed implementation plans
It also tells the agent when a doc is worth writing (architectural decisions, non-obvious bugs, new features) and when to skip (renames, trivial changes, dependency bumps).
Read more at slopdocs.dev.
License
MIT