dms_tailscalectl/skills/dms-plugin-dev/README.md
vybe 01ac7e9041 feat: add dms-plugin-dev agent skill for Dank Material Shell plugin development
- Introduces a general-purpose opencode skill to help agents build, debug, and publish DMS plugins.
- Includes orientation, decision trees (plugin types), condensed cheat sheets, ecosystem map, and four generic vertical-slice starter templates (bar widget, popout widget, launcher, desktop widget).
- Skill is versioned here for this project while remaining available as a global opencode skill.
- Updated .gitignore to ignore globally-installed copies of the skill.

Written by AI agent working for @jtmorris. Model: grok-build-0.1.
2026-05-24 09:31:06 +00:00

43 lines
No EOL
1.8 KiB
Markdown

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