_skills-evaluation-aesthetics

To evaluate skill naming clarity, review directory names and frontmatter to ensure they predict content, conform to conventions, and remain concise. Assess description quality and prose intelligibility to ensure other agents can load and use skills with confidence.

A clear skill description opens with a direct action phrase, distinguishes the skill from others, and avoids ambiguous scope. Readable prose uses immediate language with explicit mental models and minimal jargon to ensure fresh-reader intelligibility.

Check style consistency by verifying that formatting aligns with corpus standards for principles, navigation, headings, and whitespace. Review the skill's formatting against these criteria to identify deviations and produce actionable feedback for authors.

Yes, you can apply aesthetics evaluation criteria to new skills to improve prose quality. Review the skill's name, description, and prose against naming clarity, style consistency, and fresh-reader intelligibility standards to generate actionable improvement feedback.

Evaluating skill aesthetics focuses strictly on naming clarity, prose quality, style consistency, and reader intelligibility. It does not assess functional execution logic, dependency compatibility, or runtime performance, limiting its scope to documentation and formatting standards.