DankMaterialShell/.agents/skills/README.md

Agent Skills

This directory contains agent skills following the Agent Skills open standard - a portable, version-controlled format for giving AI agents specialized capabilities.

Each skill is a directory with a SKILL.md entrypoint, optional reference docs, scripts, and templates. Agents load skills progressively: metadata at startup, full instructions on activation, and supporting files on demand.

Available Skills

Skill	Description
dms-plugin-dev	Develop plugins for DankMaterialShell - covers all 4 plugin types (widget, daemon, launcher, desktop), manifest creation, QML components, settings UI, data persistence, theme integration, and PopoutService usage.

Installation

The .agents/skills/ directory at the project root is the standard location defined by the agentskills.io spec. Many agents discover skills from this path automatically. Some agents use their own directory conventions and need a symlink or copy.

Claude Code

Claude Code discovers skills from .claude/skills/ (project-level) or ~/.claude/skills/ (personal). To make skills from .agents/skills/ available, symlink them into the Claude Code skills directory:

Project-level (this repo only):

mkdir -p .claude/skills
ln -s ../../.agents/skills/dms-plugin-dev .claude/skills/dms-plugin-dev

Personal (all your projects):

ln -s /path/to/DankMaterialShell/.agents/skills/dms-plugin-dev ~/.claude/skills/dms-plugin-dev

After linking, the skill appears in Claude Code's / menu as /dms-plugin-dev, and Claude loads it automatically when you ask about DMS plugin development.

See the Claude Code skills docs for more on skill configuration, invocation control, and frontmatter options.

Cursor

Cursor discovers skills from .cursor/skills/ in the project root:

mkdir -p .cursor/skills
ln -s ../../.agents/skills/dms-plugin-dev .cursor/skills/dms-plugin-dev

See Cursor skills docs for details.

VS Code (Copilot)

VS Code Copilot discovers skills from .github/skills/ or .vscode/skills/:

mkdir -p .github/skills
ln -s ../../.agents/skills/dms-plugin-dev .github/skills/dms-plugin-dev

See VS Code skills docs for details.

Gemini CLI

Gemini CLI discovers skills from .gemini/skills/ in the project root:

mkdir -p .gemini/skills
ln -s ../../.agents/skills/dms-plugin-dev .gemini/skills/dms-plugin-dev

See Gemini CLI skills docs for details.

OpenAI Codex

Codex discovers skills from .codex/skills/ in the project root:

mkdir -p .codex/skills
ln -s ../../.agents/skills/dms-plugin-dev .codex/skills/dms-plugin-dev

See Codex skills docs for details.

Other Agents

The Agent Skills standard is supported by 30+ tools including Goose, Roo Code, JetBrains Junie, Amp, OpenCode, OpenHands, Kiro, and more. Most discover skills from a dot-directory at the project root (e.g., .goose/skills/, .roo/skills/). Some read .agents/skills/ directly.

Check the Agent Skills client showcase for setup instructions specific to your agent.

The general pattern is:

mkdir -p .<agent>/skills
ln -s ../../.agents/skills/dms-plugin-dev .<agent>/skills/dms-plugin-dev

Adding New Skills

To add a new skill to this directory:

1. Create a subdirectory named with lowercase letters, numbers, and hyphens (e.g., my-new-skill/)
2. Add a SKILL.md file with YAML frontmatter (name, description) and markdown instructions
3. Optionally add references/, scripts/, and assets/ subdirectories
4. Keep SKILL.md under 500 lines - move detailed content to reference files

See the Agent Skills specification for the full format.