# dms-plugin-dev

A focused skill for agents that builds or maintains plugins for **Dank Material Shell (DMS)**.

## What It Provides

- Strong orientation and mental model for the DMS plugin system
- Decision trees for choosing the right plugin type
- Condensed cheat sheets for the highest-uncertainty surfaces (`plugin.json`, `PluginComponent`, `PluginService`, settings, popouts, permissions, launcher shape, etc.)
- Curated ecosystem map (official docs, first-party examples, monorepo examples, registry)
- Generic, modern vertical-slice starter templates (widget, popout widget, launcher, desktop)

## Philosophy

This skill is deliberately **thin and pointer-heavy**. The official DMS documentation (especially the Plugin Development guide) is excellent and comprehensive. This skill exists to reduce the "I don't know what I don't know" problem for agents and to give them good starting points (templates) that follow current conventions.

It does **not** duplicate large sections of the official docs.

## Location in the Skill

After the skill is loaded, you will have access to:
- `SKILL.md` (entry point)
- `docs/plugin-types.md`
- `docs/cheatsheets.md`
- `docs/ecosystem.md`
- `templates/` (copy these folders wholesale when starting a new plugin)

## When to Load This Skill

Any time the user says:
- "build a DMS plugin"
- "add a widget / launcher / desktop thing to Dank Material Shell"
- "debug this plugin.json / PluginComponent"
- "publish this to the DMS plugin registry"
- or mentions any of the core DMS plugin concepts

## Maintenance

Low-maintenance by design. When the official docs or best practices evolve significantly, update the pointers and the templates. Do not try to be a second source of truth.

---

Written by AI agent working for @jtmorris. Model: grok-build-0.1.