Home / different-ai / openwork · .opencode/skills/create-plugin/SKILL.md · GitHub

create-plugin skillA

create-plugin is agent-read markdown (skill) from different-ai/openwork: Create an OpenCode plugin for OpenWork. Scaffolds the plugin file with the correct API shape, tool definitions, and hook registration. Use when the user asks to 'create a plugin', 'write a plugin', or 'make a plugin that does X'..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Skill: Create an OpenCode Plugin

Scaffold a working OpenCode plugin for use in OpenWork.

## When to use

- User asks "create a plugin that does X"
- User asks "write a plugin" or "make a plugin"
- User wants to extend OpenWork/OpenCode with custom tools

## Plugin API

An OpenCode plugin is an **async factory function** that returns a **hooks object**.

### File location

Plugins can live in:
- **Project**: `.opencode/plugins/my-plugin.ts` (auto-discovered)
- **Global**: `~/.config/opencode/plugins/my-plugin.ts`
- **npm**: published as a package, referenced in `opencode.json` `plugin` array
- **URL**: `file:` or `https:` path in the `plugin` array

### Minimal shape

```typescript
import { z } from "zod";

export default async () => ({
  tool: {
    my_tool_name: {
      description: "What this tool does.",
      args: z.object({
        input: z.string().describe("The input parameter."),
      }).shape,   // NOTE: .shape, not the ZodObject itself
      async execute(args: { input: string }) {
        // Your logic here. Can use fetch(), fs, child_process, etc.
        return `Result: ${args.input}`;
      },
    },
  },
});
```

### Key rules
…

Read the whole file at its exact version.

How to install

Latest version
mdr add different-ai/openwork/create-plugin@git:20260602.20013d2
Exact content
mdr add different-ai/openwork/create-plugin@sha256:2571541e6289ff7b

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_a5366kkjro2zvuzi.svg)](https://markdownregistry.com/a/art_a5366kkjro2zvuzi)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260602.20013d2 latest2026-06-02 20013d2 5,177 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5177 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

different-ai/openwork · 23,724 stars · license NOASSERTION · pushed 2026-09-25 · branch dev

API

GET https://markdownregistry.com/api/v1/artifacts/art_a5366kkjro2zvuzi
GET https://markdownregistry.com/api/v1/resolve?ref=different-ai/openwork/create-plugin
GET https://markdownregistry.com/api/v1/blob/2571541e6289ff7bb9a1b30a321a5153d17f8f09e6523ef3fb45a40ebb80a5b7

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from different-ai/openwork

browser-automation skill
different-ai/openwork · .opencode/skills/browser-automation/SKILL.md · Local OpenWork Electron browser automation with CDP. Use when driving a local Electron dev app, browser_list…
git:20260904.25c1014 · audit B · 23,724 stars
daytona-seeded-cloud-demo skill
different-ai/openwork · .opencode/skills/daytona-seeded-cloud-demo/SKILL.md · Daytona seeded cloud demo, demo credentials, Acme Robotics seed. Use when the user asks to spin up, keep running, seed…
git:20260827.92f4f3f · audit B · 23,724 stars
daytona-windows-cert skill
different-ai/openwork · .opencode/skills/daytona-windows-cert/SKILL.md · test on Windows, enterprise CA, corporate certificate, GPO cert, TLS fetch failed, Windows sandbox, daytona windows…
git:20260904.25c1014 · audit A · 23,724 stars
daytona skill
different-ai/openwork · .opencode/skills/daytona/SKILL.md · Daytona CLI setup, sandbox debugging, keep a sandbox alive, secrets volume, snapshot refresh. Use when Daytona itself…
git:20260905.46ba486 · audit A · 23,724 stars
diagnose-a-red-run skill
different-ai/openwork · .opencode/skills/diagnose-a-red-run/SKILL.md · Test is red, typecheck failed, CI job failed, flaky, timed out, was this already broken. Use to classify any failing…
git:20260921.bbe08f8 · audit A · 23,724 stars
get-env-var skill
different-ai/openwork · .opencode/skills/get-env-var/SKILL.md · get an env var, fetch a secret, missing env var, missing token/API key, load secrets from Infisical, infisical. Fetch…
git:20260902.114ecbd · audit A · 23,724 stars
hunt-a-prod-error skill
different-ai/openwork · .opencode/skills/hunt-a-prod-error/SKILL.md · A user saw internal_error, "Unexpected server error", a 500, or an opaque failure in a shipped OpenWork build. Find the…
git:20260921.bbe08f8 · audit A · 23,724 stars
open-a-pr skill
different-ai/openwork · .opencode/skills/open-a-pr/SKILL.md · Open a PR, write or rewrite a PR description, "the PR body is too long", or check whether a PR description is readable…
git:20260923.b2fdf64 · audit A · 23,724 stars
openwork-models skill
different-ai/openwork · .opencode/skills/openwork-models/SKILL.md · Manage OpenWork inference model aliases, openwork model overlays, discounts, validation, and automated base model…
git:20260911.4fa0232 · audit B · 23,724 stars
preview-my-work skill
different-ai/openwork · .opencode/skills/preview-my-work/SKILL.md · Boot, reopen, update, or reset OpenWork PR previews. Discover script worlds, use configurable app-web locally or…
git:20260924.c340d9e · audit A · 23,724 stars
record-a-demo skill
different-ai/openwork · .opencode/skills/record-a-demo/SKILL.md · Screenshots, recording, and presentation artifacts.
git:20260921.bbe08f8 · audit B · 23,724 stars
release skill
different-ai/openwork · .opencode/skills/release/SKILL.md · Cut an OpenWork release, release the app, publish a new version, rerun or recover a release tag, verify release assets…
git:20260910.e2267a9 · audit A · 23,724 stars

Every file in different-ai/openwork

Other files named create-plugin

create-plugin skill
devin-axis/ipollowork · .opencode/skills/create-plugin/SKILL.md · Create an OpenCode plugin for iPolloWork. Scaffolds the plugin file with the correct API shape, tool definitions, and…
git:20260711.1ecdca5 · audit A · 6,668 stars
create-plugin skill
avirtual/clodex · plugins/clodex-plugin-builder/skills/create-plugin/SKILL.md · Build a Clodex plugin end to end - scaffold it, wire the surfaces it needs, and verify it against the real loader…
git:20260906.8cfbd80 · audit B · 116 stars
create-plugin skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-forgecat/platforms/codex/.agents/skills/create-plugin/SKILL.md · Guided end-to-end plugin creation workflow with component design, implementation,
git:20260915.3d0f78f · audit A · 85 stars
create-plugin skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-codex/.agents/skills/create-plugin/SKILL.md · Guided end-to-end plugin creation workflow with component design, implementation,
git:20260915.3d0f78f · audit A · 85 stars
create-plugin skill
riot-org/riot · crates/riot-kernel/builtin/skills/create-plugin/SKILL.md · 用户想写一个 Riot 插件、把已有的技能/命令/hooks/MCP 打包分发、或把 Claude Code / Cursor 插件搬到 Riot 时用。目录布局、三种清单格式、dev.riot 扩展字段、本地链接调试流程和市场发布。
git:20260913.5e905fe · audit A · 20 stars
create-plugin skill
andersonlimahw/lemon-ai-hub · plugins/create-plugin/SKILL.md · Scaffold a new AI agent plugin directory with valid manifest, component directories, and marketplace wiring. Use when…
git:20260801.d400e34 · audit A · 14 stars
create-plugin skill
richfrem/agent-plugins-skills · plugins/agent-scaffolders/skills/create-plugin/SKILL.md · Scaffolds a new top-level agent plugin directory. NOT for scaffolding single skills (use `create-skill`) and NOT for…
git:20260907.506f5de · audit A · 6 stars

Browse by kind, by grade A, or by owner.