Devin plugin template

A starter template for building Devin plugins: installable bundles of skills, rules, subagents, hooks, and MCP servers that work across Devin Cloud, the Devin CLI, and Devin Desktop.

Plugins are in beta and behavior is subject to change. See the CLI plugins reference for more information.

What's inside

Three example plugins:

• hello-world: A simple example of an always-on rule (AGENTS.md) and one skill
• team-conventions: Always-on, glob, and model-decision triggered rules, plus a skill
• kitchen-sink: Everything a plugin can ship: rules (including manual-trigger), skills, a subagent, hooks, an MCP server, and governance (requiredPlugins / optionalPlugins / forbiddenPlugins)

Getting started

1. Use this template to create a repo.
2. Start from the tier closest to what you're building: rename it (folder and manifest name) and replace the placeholder content.
3. Install and try it:

# From a local folder — edits are live, no update step needed
devin plugins install ./plugins/hello-world

# Or from git, per plugin
devin plugins install "https://github.com/<your-org>/plugin-template.git#plugins/hello-world"

Then start a session: the always-on rule is injected, and the skill is available as /hello-world:hello.

Only building one plugin? Move its contents to the repo root (keep .devin-plugin/plugin.json) and delete plugins/ — then devin plugins install <owner>/<repo> installs the repo itself.

Validation

CI runs node scripts/validate-plugins.mjs on every PR. It checks that every plugin has a valid manifest with a unique kebab-case name, that skills and subagents have the required frontmatter, and that hooks/MCP files are valid JSON.