Agent skill

Create Opencode Plugin

by IgorWarzocha in IgorWarzocha/Opencode-Workflows

Create OpenCode plugins using the @opencode-ai/plugin SDK. An agent skill from IgorWarzocha/Opencode-Workflows.

No licenceAuto-check passedDevelopment

Install Create Opencode Plugin

skills CLI
$ npx skills add IgorWarzocha/Opencode-Workflows --skill create-opencode-plugin -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install IgorWarzocha/Opencode-Workflows create-opencode-plugin --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/IgorWarzocha/Opencode-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/create-opencode-plugin/.opencode/skill/create-opencode-plugin .claude/skills/create-opencode-plugin && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
create-opencode-plugin
GitHub stars
122
Token cost
~2.4k tokens
SKILL.md length
652 words
Files
13 (incl. scripts, references)
Skills in repo
37
Repo updated
First seen
Licence
None found

At a glance

Create OpenCode plugins using the @opencode-ai/plugin SDK. An agent skill from IgorWarzocha/Opencode-Workflows.

  • Works in 7 steps: Verify SDK Reference (REQUIRED) → Validate Feasibility (REQUIRED) → Design Plugin → …
  • Building custom tools
  • SKILL.md covers Procedure Overview, Step 1: Verify SDK Reference…, Step 2: Validate Feasibility… and Step 3: Design Plugin, plus 5 more sections
  • Runs TypeScript scripts from its folder; calls opencode and bun

What it does

Create Opencode Plugin is an agent skill from IgorWarzocha/Opencode-Workflows. Create OpenCode plugins using the @opencode-ai/plugin SDK. Use for building custom tools, event hooks, auth providers, or tool execution interception. Use proactively when developing new plugins in .opencode/plugin/ or ~/.config/opencode/plugin/. Examples: - user: "Create a plugin to block dangerous commands" → implement tool execution before hook with blocking logic - user: "Add a custom tool for jira" → design tool schema and implementation using SDK context - user: "Show toast on file edit" → react to file…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `references/CODING-TS.MD`, `references/events.md` and `references/examples.md`).

It sits in Development, covering Commit messages, Authentication and Hooks and plugins. It works with React and Jira. The repository describes itself as: An ever evolving repository of Opencode workflow examples that might enhance your experience with it. I only left the stuff that actually works. YMMV.

When your agent uses it

  • Building custom tools
  • Tool execution interception

Example prompts

  • “Create a plugin to block dangerous commands”
  • “Add a custom tool for jira”
  • “Show toast on file edit”
  • “/create-opencode-plugin”

Requirements

  • Node.js

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Verify SDK Reference (REQUIRED)
  2. Validate Feasibility (REQUIRED)
  3. Design Plugin
  4. Implement
  5. Add UI Feedback (Optional)
  6. Test
  7. Publish (Optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 6444ec4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • opencode
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Create Opencode Plugin loads about 2.4k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 187 tokens; SKILL.md has 652 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~187
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~18k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 652 words (~2,428 tokens).

“Re-read this file periodically during plugin development to refresh context and ensure you're following the correct procedure.”

— opening of SKILL.md by IgorWarzocha
name
create-opencode-plugin

Read the full SKILL.md on GitHub

Files

SKILL.md and 12 other files (scripts, references) in agents/create-opencode-plugin/.opencode/skill/create-opencode-plugin of IgorWarzocha/Opencode-Workflows.

  • SKILL.md
  • references/CODING-TS.MD
  • references/events.md
  • references/examples.md
  • references/hook-patterns.md
  • references/hooks.md
  • references/publishing.md
  • references/testing.md
  • references/toast-notifications.md
  • references/tool-helper.md
  • references/ui-feedback.md
  • references/update-notifications.md
  • scripts/extract-plugin-api.ts

Open the folder on GitHubat commit 6444ec4

Compare with similar skills

Create Opencode Plugin next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Create Opencode Plugin compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Opencode Plugin this skillIgorWarzocha/Opencode-Workflows122—~2.4kAutomated safety check: PassNone
LangBot Core Developmentlangbot-app/LangBot18k—~1.4kAutomated safety check: NotesApache-2.0
Cut Releasedelexw/claude-code-trace3761 repos~1.4kAutomated safety check: PassMIT
Release WorkflowCaldis/react-zmage946—~3.6kAutomated safety check: NotesMIT
Commit Workbartstc/vite-ts-react-template1223 repos~623Automated safety check: PassMIT
Git Workflowsoftmaple/softmaple159—~814Automated safety check: PassApache-2.0

Similar skills

  • LangBot Core Development

    langbot-app/LangBot

    Covers developing the LangBot core backend and web UI: dev setup, repo layout, API auth types, adding endpoints, migrations and keeping the MCP server in step.

    18k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check: notes
  • Cut Release

    delexw/claude-code-trace

    Cuts a new versioned release of claude-code-trace end-to-end without asking any questions.

    376 GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Release Workflow

    Caldis/react-zmage

    A skill your agent uses when the user wants to ship a new version of react-zmage to npm.

    946 GitHub stars~3.6k tokensUpdated 4 mo ago
    DevelopmentAuto-check: notes
  • Commit Work

    bartstc/vite-ts-react-template

    Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits).

    122 GitHub starsUsed in 3 repos~623 tokens
    DevelopmentAuto-check passed
  • Git Workflow

    softmaple/softmaple

    Softmaple Git branching, commits, pre-commit hooks, and pull requests.

    159 GitHub stars~814 tokensUpdated today
    DevelopmentAuto-check passed
  • Conventional Commit

    jetstreamapp/jetstream

    Write a commit message for the current changes - conventional commit format, a short body, issue references in the footer.

    125 GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from IgorWarzocha/Opencode-Workflows

All 37 skills in this repo
  • Plugin Installer

    IgorWarzocha/Opencode-Workflows

    Find, install, and configure OpenCode plugins from the catalog or community.

    122 GitHub stars~1.3k tokensUpdated 8 mo ago
    Auto-check passed
  • Skill Creator

    IgorWarzocha/Opencode-Workflows

    Guide for creating effective opencode skills. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~2.8k tokensUpdated 8 mo ago
    Auto-check passed
  • Security AI Keys

    IgorWarzocha/Opencode-Workflows

    Review AI API key leakage patterns and redaction strategies.

    122 GitHub stars~793 tokensUpdated 8 mo ago
    Auto-check: notes
  • Security Convex

    IgorWarzocha/Opencode-Workflows

    Review Convex security audit patterns for authentication and authorization.

    122 GitHub stars~3.1k tokensUpdated 8 mo ago
    Auto-check passed
  • Security Django

    IgorWarzocha/Opencode-Workflows

    Review Django security audit patterns for settings and middleware.

    122 GitHub stars~1.6k tokensUpdated 8 mo ago
    Auto-check: notes
  • Security Docker

    IgorWarzocha/Opencode-Workflows

    Review Docker and container security audit patterns. An agent skill from IgorWarzocha/Opencode-Workflows.

    122 GitHub stars~1.6k tokensUpdated 8 mo ago
    Auto-check: notes

Works with

Categories

Questions about Create Opencode Plugin

What does Create Opencode Plugin do?

Create OpenCode plugins using the @opencode-ai/plugin SDK. An agent skill from IgorWarzocha/Opencode-Workflows. Create Opencode Plugin is an agent skill from IgorWarzocha/Opencode-Workflows. Create OpenCode plugins using the @opencode-ai/plugin SDK.

When should I use Create Opencode Plugin?

Create Opencode Plugin fits situations like: building custom tools; tool execution interception.

How do I install Create Opencode Plugin in Claude Code?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill create-opencode-plugin -a claude-code`. Or copy the skill folder (agents/create-opencode-plugin/.opencode/skill/create-opencode-plugin in IgorWarzocha/Opencode-Workflows) into .claude/skills/create-opencode-plugin in your project. Claude Code loads it when a task matches its description.

How do I install Create Opencode Plugin in Codex?

Run `npx skills add IgorWarzocha/Opencode-Workflows --skill create-opencode-plugin -a codex`. Or copy the skill folder (agents/create-opencode-plugin/.opencode/skill/create-opencode-plugin in IgorWarzocha/Opencode-Workflows) into .agents/skills/create-opencode-plugin in your project. Codex loads it when a task matches its description.

Can I use Create Opencode Plugin in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add IgorWarzocha/Opencode-Workflows --skill create-opencode-plugin -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-opencode-plugin, .gemini/skills/create-opencode-plugin, .github/skills/create-opencode-plugin and .opencode/skills/create-opencode-plugin in your project.

What does Create Opencode Plugin need to run?

Going by SKILL.md and its folder, Create Opencode Plugin needs TypeScript for the scripts in its folder and the command-line tools its instructions call (opencode and bun). Our summary lists: Node.js.

Does Create Opencode Plugin access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Create Opencode Plugin safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Create Opencode Plugin use?

No licence was found for Create Opencode Plugin or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Create Opencode Plugin use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 16k tokens, read only when the agent opens those files.

What are the alternatives to Create Opencode Plugin?

Skills that share tags, products or a category with Create Opencode Plugin: LangBot Core Development (langbot-app/LangBot, 18k stars), Cut Release (delexw/claude-code-trace, 376 stars), Release Workflow (Caldis/react-zmage, 946 stars) and Commit Work (bartstc/vite-ts-react-template, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create Opencode Plugin?

IgorWarzocha (a GitHub user) maintains it in IgorWarzocha/Opencode-Workflows, which has 122 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on February 4, 2026.

Source: IgorWarzocha/Opencode-Workflows on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.