_skills-evaluation-user

To evaluate skill discoverability, review the frontmatter and description to assess whether they clearly communicate the skill's purpose and route users to the right outcomes. Check actionability, predictability, and proportionality across typical user tasks.

A clear skill description explicitly communicates its purpose, ensures actionable routing to outcomes, and maintains consistency in evaluation criteria. It should allow users to predict results and understand the scope of typical tasks in real-world usage.

Assess frontmatter by verifying it explicitly states the skill's purpose, supports predictable user routing, and provides proportional guidance for typical tasks. Ensure the evaluation criteria remain consistent and actionable for both users and contributors.

Yes, you can apply user-experience evaluation criteria to improve frontmatter by identifying gaps in discoverability and actionability. The feedback helps refine descriptions so first-time users and contributors understand the skill's purpose and routing immediately.

Evaluating skill usefulness through frontmatter and description alone limits the assessment to metadata clarity and routing predictability. It does not test the skill's internal execution logic or validate actual outcomes during real-world task processing in Claude Code.

Yes, the skill evaluation process is designed for loading in Claude Code, ensuring evaluation criteria are explicit, consistent, and actionable for both users and contributors when assessing skill definitions in that environment.