.aider-desk/skills/skill-creator/SKILL.md
Create AiderDesk Agent Skills by writing SKILL.md files, defining frontmatter metadata, structuring references, and organizing skill directories. Use when building a new skill, creating a SKILL.md, planning skill architecture, or writing skill content.
npx skillsauth add hotovo/aider-desk skill-creatorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create effective Agent Skills using progressive disclosure.
Create a skill when you notice:
Skills load in 3 levels:
Key: Keep Levels 1 & 2 lean. Move details to Level 3.
.aider-desk/skills/my-skill/SKILL.md with YAML frontmatter (name, description) and body instructionsreferences/ as neededIf skill doesn't load: check YAML syntax is valid, name is lowercase-hyphenated, and description contains the trigger terms users would say
---
name: deploy-helper
description: Deploy AiderDesk builds to staging and production environments. Use when deploying, releasing, or publishing builds.
---
# Deploy Helper
Build and deploy AiderDesk to target environments.
## Steps
1. Run `npm run build` to generate production artifacts
2. Verify build output exists in `dist/`
3. Deploy to staging: `./scripts/deploy.sh staging`
4. Verify deployment: check health endpoint returns 200
## Troubleshooting
- Build fails: check `tsconfig.json` paths and run `npm run typecheck`
## References
- [environments.md](references/environments.md) - Environment configs
my-skill/
├── SKILL.md # Core instructions + metadata
├── references/ # Detailed docs (loaded as needed)
├── scripts/ # Executable operations
└── assets/ # Templates, images, files
development
Write unit tests, component tests, and integration tests for AiderDesk using Vitest and React Testing Library. Use when creating new tests, adding test coverage, configuring mocks, setting up test files, or debugging failing tests.
development
Create new AiderDesk UI themes by defining SCSS color variables, registering theme types, and adding i18n display names. Use when adding a theme, creating a color scheme, customizing appearance, or implementing dark mode and light mode variants.
tools
Create AiderDesk extensions by setting up extension files, defining metadata, implementing Extension interface methods, and updating documentation. Use when building a new extension, creating extension commands, tools, or event handlers.
tools
Create and configure AiderDesk agent profiles by defining tool groups, approval rules, subagent settings, and provider/model selection. Use when setting up a new agent, creating a profile, or configuring agent tools and permissions.