skill-conventions

What problem does it solve?

Skill files for agentz can be inconsistent, missing required metadata, or lack clear guidance for scripts and cached context, which leads to broken auto-loading, unpredictable agent behavior, and fragile automation. This Skill documents conventions and templates so authors produce reliable, discoverable, and safe SKILL.md files.

Core Features & Use Cases

• Template for SKILL.md including required YAML frontmatter and H1 title to ensure discovery and consistent loading.
• Frontmatter rules for name, description, visibility flags, and when to hide or disable model invocation.
• Guidance for adding deterministic scripts: non-interactive design, structured JSON output, meaningful exit codes, --help and --dry-run support, idempotency, and minimal dependencies.
• Cached context patterns and memory file naming rules to persist stable user settings without storing secrets.
• Checklist and examples for reviewers creating or validating new skills.

Quick Start

Create a new skill by adding a SKILL.md with a YAML frontmatter containing name and description, an H1 title, and any optional scripts or memory file references.