What problem does it solve?
This Skill eliminates the guesswork and errors involved in creating in-repo VIGIL agent skills, ensuring all new skills pass validation, match peer conventions, and follow established quality standards without requiring contributors to memorize complex rules.
Core Features & Use Cases
- Frontmatter & Validation Guidance: Provides exact requirements for valid YAML frontmatter, size limits, and naming conventions to pass the VIGIL skill manager validator on the first try.
- Structure & Quality Standards: Defines peer-matched document structure and writing quality principles to keep skills predictable, maintainable, and free of common issues like no-op prose or duplicated rules.
- End-to-End Authoring Workflows: Covers full workflows for creating new in-repo skills, editing existing ones, adding supporting reference files, and cross-referencing related skills, plus common pitfalls and verification checklists.
- Use Case: For example, a VIGIL contributor adding a new incident response skill to the repository can use this guide to ensure the skill is placed in the correct category, has valid frontmatter, follows the expected structure, and avoids common mistakes like using the wrong creation command or writing overly generic descriptions.
Quick Start
Use the vigil-agent-skill-authoring skill to draft, validate, and commit a new in-repo VIGIL skill that adheres to all frontmatter, structure, and quality requirements.
