Easyskillz 0.5.1 reference
Easyskillz keeps canonical skills in .easyskillz/skills/<name>/ and materializes complete native directories for configured agent surfaces.
Safety contract
- Preview every mutation with
--dry-run. - Apply explicit document, migration, format, and repair operations with
--write. - Never edit generated targets; edit the canonical skill directory and sync again.
- Invalid YAML is diagnosed, never silently repaired.
- Cleanup requires local ownership state and an unchanged artifact identity.
project syncdoes not manage instruction files.
Canonical commands
skill
easyskillz skill addeasyskillz skill removeeasyskillz skill activateeasyskillz skill deactivateeasyskillz skill listeasyskillz skill validateeasyskillz skill formateasyskillz skill repair
tool
easyskillz tool registereasyskillz tool unregistereasyskillz tool list
project
easyskillz project synceasyskillz project doctoreasyskillz project exporteasyskillz project migrate
docs
easyskillz docs adopteasyskillz docs synceasyskillz docs restoreeasyskillz docs list
Common workflows
easyskillz skill validate
easyskillz skill add review-pr --dry-run
easyskillz project sync --dry-run
easyskillz project doctor --strict
easyskillz project migrate --dry-run
easyskillz docs adopt docs/AGENTS.source.md --target AGENTS.md --dry-run
easyskillz docs sync --dry-run
Human aliases sync, doctor, and add <name> remain deprecated compatibility shims through 0.5.x. Prefer canonical commands.