create-plugin SKILL.md skillA

create-plugin from different-ai/openwork is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add different-ai/openwork/create-plugin@git:20260602.20013d2

Pins git:20260602.20013d2 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

different-ai/openwork

Path

.opencode/skills/create-plugin/SKILL.md

Versions recorded

1

Latest version

git:20260602.20013d2, committed Jun 2, 2026

Size

5,177 bytes

Repository stars

24,407

License

a license file GitHub does not identify

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'.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

mdr add different-ai/openwork/create-plugin@sha256:2571541e6289ff7b

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

Versions

The registry has recorded 1 version of this file, committed on Jun 2, 2026.

Audit of the latest version

Source

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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from different-ai/openwork

Every file in different-ai/openwork

Other files named create-plugin

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