zeus-agent-skill-authoring

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

The validator requires name and description, but the repo standard also expects version, author, license, platforms, and metadata.zeus tags and related_skills. The file must start with --- at byte zero and close the frontmatter before a non-empty body.

Bundled skills/ is for daily-driver behavior useful across many user types, roughly five or more sessions per month. 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 committed skill until a new session begins. This is expected behavior, not a bug.

The repo hardline is 60 characters, one sentence ending with a period, even though the validator allows up to 1024. The system prompt index truncates at 57 characters, so the trigger must be self-contained in that window.