What problem does it solve? Writing agent skills that are portable, concise, and correctly triggered is error-prone: frontmatter gets bloated, descriptions miss triggering conditions, and stale or redundant content accumulates. This Skill provides the rules for creating, revising, organizing, and auditing agent skills so they stay discoverable and maintainable. ## Core Features & Use Cases - Skill creation guidance: Defines where skills live (global ~/.agents/skills/<name>/SKILL.md vs repository-specific), naming conventions, and frontmatter rules limited to name and description. - Content and resource rules: Specifies when to add scripts/, references/, and assets/, and prohibits duplicative README or changelog files. - Revision and validation workflow: Instructs reading existing skills before editing, removing stale or contradictory content, and validating frontmatter, links, and scripts. - Use Case: When a recurring workflow emerges, ask the agent to convert it into a global skill; it will create a hyphen-case directory with minimal frontmatter and capability-based instructions. ## Quick Start Ask the agent to turn this recurring workflow into a global skill stored under the dotfiles agents skills directory.
