skill-creator
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.
How do I install this agent skill?
npx skills add https://github.com/hotovo/aider-desk --skill skill-creatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill-creator package provides comprehensive documentation and architectural guidelines for building AI agent skills using progressive disclosure. It includes best practices, coding patterns, and a reference for the 'claude-skills-cli' validation tool, without containing any executable scripts or malicious instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
7/7 files flagged
What does this agent skill do?
Skill Creator
Create effective Agent Skills using progressive disclosure.
When to Create a Skill
Create a skill when you notice:
- Repeating context across conversations
- Domain expertise needed repeatedly
- Project-specific knowledge the agent should know automatically
Progressive Disclosure
Skills load in 3 levels:
- Metadata (~27 tokens) - YAML frontmatter for triggering
- Instructions (<680 tokens) - SKILL.md body with core patterns
- Resources (unlimited) - references/ scripts/ assets/ loaded on demand
Key: Keep Levels 1 & 2 lean. Move details to Level 3.
Quick Workflow
- Create skill directory:
.aider-desk/skills/my-skill/ - Write
SKILL.mdwith YAML frontmatter (name,description) and body instructions - Add detailed docs to
references/as needed - Verify: mention a trigger keyword — skill should appear in active skills sidebar
If skill doesn't load: check YAML syntax is valid, name is lowercase-hyphenated, and description contains the trigger terms users would say
SKILL.md Example
---
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
Structure
my-skill/
├── SKILL.md # Core instructions + metadata
├── references/ # Detailed docs (loaded as needed)
├── scripts/ # Executable operations
└── assets/ # Templates, images, files
References
- quick-start.md - Creating your first skill
- writing-guide.md - Writing effective skills
- development-process.md - Step-by-step workflow
- skill-examples.md - Patterns and examples
- cli-reference.md - CLI tool usage
- agent-skills-resources.md - Architecture and best practices
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hotovo/aider-desk/skill-creator">View skill-creator on skillZs</a>