son-of-anton-skill-authoring

Write the file with write_file to skills/<category>/<name>/SKILL.md or optional-skills/<category>/<name>/SKILL.md, then git add and commit. Do not use skill_manage(action='create'), which only targets the user-local ~/.son-of-anton/skills/ directory.

The validator requires name and description, but the repo standard also expects version, author, license, platforms, and metadata.son-of-anton with tags and related_skills. The description must be 60 characters or fewer, one sentence, and end with a period.

Bundled skills/ is for daily-driver behavior useful across many user types with a 5+ sessions per month bar. Niche, vertical-specific, or heavy skills belong in optional-skills/. When in doubt, choose optional since promoting later is easier than demoting.

The skill loader is initialized at session start and cached, so skill_view and skills_list will not see a newly added skill until a new session begins. This is expected behavior, not a bug.

Audit what the skill's prose and scripts actually invoke rather than copying a sibling. Cross-platform tools get [linux, macos, windows]; bash pipelines get [linux, macos]; osascript gets [macos]; apt or /proc usage gets [linux].