skill-writing

Standardize SKILL.md files by applying a concise template that enforces mandatory frontmatter fields like name and description, ensuring consistent structure and actionable rules for reliable PR reviews.

A SKILL.md template should include well-defined sections for Obligations, Recommendations, Anti-patterns, Examples, and a Checklist to improve clarity for both humans and LLMs.

Standardizing skill documentation improves LLM automation by providing a consistent structure with mandatory frontmatter and clear guidelines, which makes the files easier for both humans and LLMs to parse and apply.

Yes, you can use optional directories such as scripts, references, and assets within your repository, and the template provides clear instructions on how to utilize them alongside the main SKILL.md file.

The best way to structure obligations and anti-patterns is to separate them into distinct, well-defined sections within the standardized template, simplifying the review process and ensuring actionable rules are clearly communicated.