@howaboua/opencode-workflows-tool

Opencode Workflows Tool (aka skills but better)

An addition to OpenCode’s skill tool that helps agents capture repeatable SOPs and reuse them across sessions, including a workflow-create tool with YAML frontmatter protection.

Why? Agents tend to dislike the word “skill". They think they've already got all the skills necessary to perform the task. This plugin reframes that behavior around workflows/SOPs and enables agents to create and refine repo-standard-workflows during long-running sessions. Given it's hot-reload, it also works across subagents. If your subagent defines a workflow, it will appear as reusable across all the running sessions/subsessions.

Why not global? A bit opinionated, but I believe skills should be global, and carefully selected to be used only by specific agents to avoid context rot. And not every skill will apply to every project you're working on.

Features

• Tools exposed: workflows and workflows_create for listing, loading, and creating SOPs
• Workflow discovery: Scans .opencode/workflows/**/WORKFLOW.md in the current repo
• Workflow creation: workflows_create writes new workflows from structured name/body input
• System prompt injection: Always exposes <available_workflows> to the main agent and subagents
• Hot reload friendly: New workflows are discoverable immediately during ongoing sessions

Installation

Add to your repo opencode.json or .opencode/opencode.jsonc (preferred):

{
  "plugin": ["@howaboua/opencode-workflows-tool@latest"],
}

Or reference a local plugin file:

{
  "plugin": ["file:///absolute/path/to/your/plugin/src/index.ts"],
}

Usage

List available workflows:

Use the workflows tool with no arguments to list available workflows.

Load a workflow:

Use the workflows tool with workflow: "release-checklist".

Create a new workflow after a successful, repeatable process:

Use workflows_create with name: "release-checklist" and body containing the SOP steps.

Development

# Install dependencies
bun install

# Build
bun run build

# Watch mode
bun run dev

License

MIT