fboldo/oiap / skills/create-plugin
create-plugin
UnverifiedUse this skill when the user needs to write, scaffold, or improve an OIAP agent plugin in TypeScript, create an oiap.plugin.ts file, define commands, instructions, skills, hooks, agents, or policies, or build target bundles with the OIAP CLI.
Create OIAP Plugin
Use this skill when the user needs to write an agent plugin in TypeScript using OIAP.
OIAP lets plugin authors define a plugin once and export host-native bundles for multiple agent platforms. Treat OIAP as an external SDK and CLI unless the user is explicitly working inside the OIAP source repository.
First Response
Start by identifying the plugin shape the user wants:
- What should the plugin help an agent do?
- Which targets matter first, such as
claude-code,codex,cursor,openclaw,vscode-copilot-chat, orantigravity? - Does the plugin need commands, always-on instructions, skills, hooks, agents, MCP tools, executable recipes, or policies?
- Should generated bundles be committed, published, or only built locally for review?
If the request is already clear, do not over-interview. Scaffold the smallest useful plugin and explain where to extend it.
Install OIAP
For normal plugin projects, use the published OIAP CLI and SDK.
Use the existing project package manager in commands and examples. If the
project already uses bun, pnpm, yarn, or npm, follow that choice
instead of switching tools. Only fall back to npm when the project has no
clear package manager yet.
Install the OIAP packages with that package manager. For example:
# npm
npm install --save-dev @oiap/cli @oiap/core
# pnpm
pnpm add -D @oiap/cli @oiap/core
# yarn
yarn add --dev @oiap/cli @oiap/core
# bun
bun add --dev @oiap/cli @oiap/core
Use npx oiap in examples and instructions:
npx oiap targets
npx oiap build oiap.plugin.ts --target claude-code --out dist/claude-code
npx oiap build oiap.plugin.ts --out dist/oiap
Do not tell users to clone the OIAP repository unless they are contributing to OIAP itself.
Authoring Rules
- Create an
oiap.plugin.tsfile that exportsdefinePlugin(...)as the default export. - Import from
@oiap/core; avoid repository-relative imports. - Put larger prompts and agent instructions in Markdown files and load them with
markdownFile("path.md", { baseUrl: import.meta.url }). - Keep target-specific overrides small. Prefer portable primitives first.
- Declare
supportedTargetshonestly. Use only targets the user wants to build or verify. - Include policies when hooks, tools, scripts, network access, file writes, secrets, or destructive actions are involved.
- Build target bundles into
dist/and tell the user that OIAP generates artifacts; installing those artifacts into a host is handled by the host or the user's own workflow.
Project Shape
Use this default layout for a new plugin:
my-plugin/
package.json
tsconfig.json
oiap.plugin.ts
prompts/
command.md
Add only the folders needed by the plugin:
agents/ Custom agent instruction Markdown
prompts/ Command, skill, workflow, and safety prompts
schemas/ JSON schemas for invocation or tool arguments
recipes/ Executable command recipe source files
policies/ Permission and safety policy helpers
Workflow
- Decide the plugin intent and target platforms.
- Choose the smallest primitive set that represents the behavior.
- Create or update
package.json,tsconfig.json,oiap.plugin.ts, and any prompt Markdown files. - Run
npx oiap targetsso the user can see available exporters. - Build at least one requested target with
npx oiap build. - Review generated capability reports and mention any degraded or unsupported capabilities.
Primitive Selection
Use this mapping when deciding what to create:
| User need | OIAP primitive |
|---|---|
| Slash command or named action | invocations, instructions, commands |
| Reusable prompt bundle | instructions, skills |
| Always-on repository guidance | rules or always-on instructions |
| Pre/post lifecycle behavior | hooks |
| Specialized worker persona | agents plus agent instructions |
| External tools or MCP server | tools |
| Scripted shell operation | recipes and runtimeModules when needed |
| Permissions or safety posture | policies |
References
Read references/plugin-patterns.md when you need copyable OIAP examples for command plugins, hook plugins, agent plugins, or policies.
Output Style
When you create files, summarize:
- The plugin behavior.
- The primitives used.
- The build command to generate bundles.
- Any target-specific limitations or policies the user should review.
Keep explanations focused on the user's plugin, not on OIAP internals.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |