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.
89
86%
Does it follow best practices?
Impact
89%
1.03xAverage score across 3 eval scenarios
Passed
No known issues
Skill directory structure and SKILL.md frontmatter
Correct install path
100%
100%
SKILL.md exists
100%
100%
YAML frontmatter present
100%
100%
Name is kebab-case
100%
100%
Description has trigger phrase
50%
100%
Description mentions technology
100%
100%
No extra YAML fields
100%
100%
Imperative voice
80%
100%
Quick Start section
20%
0%
References directory used
100%
100%
Reference links have context
100%
100%
SKILL.md is lean
44%
100%
Reference file organization and content quality
SKILL.md is slim
100%
100%
Descriptive reference filenames
100%
100%
Links have context text
80%
70%
No JWT duplication
100%
100%
Procedural not conceptual
100%
100%
Code has full context
70%
60%
Multiple reference files
100%
100%
Quick Start preserved
100%
100%
Refactor notes explain decisions
100%
100%
No broken reference links
100%
100%
Skill validation, scripts, and assets
Script has shebang
100%
100%
Script has JSDoc header
90%
100%
Script uses argument parsing
40%
40%
Script has exit codes
100%
100%
Script output formatting
100%
100%
Assets in subdirectory
0%
0%
validation-report.txt exists
100%
100%
CLI was actually invoked
100%
100%
SKILL.md describes scripts
100%
100%
build-log.md documents structure
100%
100%
SKILL.md description has trigger phrase
100%
100%
9bcd9bb
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.