Files
gh-lyndonkl-claude/skills/cognitive-design/resources/evaluation-rubric.json
2025-11-30 08:38:26 +08:00

84 lines
4.1 KiB
JSON

{
"criteria": [
{
"name": "Completeness",
"description": "Are all required components present and comprehensive?",
"scores": {
"1": "Major components missing - skill has significant gaps in coverage",
"2": "Several important components missing or incomplete - limited utility",
"3": "Core components present but some supporting elements missing - adequate coverage",
"4": "Nearly complete with only minor gaps - good comprehensive coverage",
"5": "Exceptionally complete - all core and supporting components present with depth"
}
},
{
"name": "Clarity",
"description": "Are instructions clear, unambiguous, and easy to understand?",
"scores": {
"1": "Instructions confusing or ambiguous - difficult to follow",
"2": "Some clarity but significant ambiguity remains - requires interpretation",
"3": "Generally clear with occasional ambiguity - mostly understandable",
"4": "Clear and well-explained with minimal ambiguity - easy to follow",
"5": "Crystal clear with excellent explanations and examples - no ambiguity"
}
},
{
"name": "Actionability",
"description": "Can the skill be followed step-by-step and applied in practice?",
"scores": {
"1": "Theoretical only - no actionable steps or practical guidance",
"2": "Limited actionability - some steps but difficult to apply",
"3": "Adequately actionable - can be followed with some effort",
"4": "Highly actionable - clear steps and practical application guidance",
"5": "Exceptionally actionable - detailed steps, examples, and immediate applicability"
}
},
{
"name": "Structure",
"description": "Is the skill logically organized with clear navigation?",
"scores": {
"1": "Poorly organized - difficult to navigate, no clear structure",
"2": "Weak organization - some structure but hard to find information",
"3": "Adequately organized - logical structure, acceptable navigation",
"4": "Well organized - clear structure and easy navigation",
"5": "Exceptionally organized - intuitive structure, excellent navigation, linked resources"
}
},
{
"name": "Examples",
"description": "Are sufficient concrete examples provided to illustrate concepts?",
"scores": {
"1": "No examples provided - purely theoretical",
"2": "Minimal examples - insufficient to illustrate concepts clearly",
"3": "Adequate examples - covers main concepts with at least one example each",
"4": "Good examples - multiple concrete illustrations across most concepts",
"5": "Excellent examples - comprehensive concrete illustrations for all major concepts"
}
},
{
"name": "Triggers",
"description": "Is 'when to use' clearly defined with specific trigger conditions?",
"scores": {
"1": "No trigger conditions specified - unclear when to use",
"2": "Vague triggers - difficult to know when skill applies",
"3": "Adequate triggers - general guidance on when to use",
"4": "Clear triggers - specific conditions and scenarios well-defined",
"5": "Excellent triggers - comprehensive when/when-not guidance with concrete scenarios"
}
},
{
"name": "Cognitive Foundation",
"description": "Are cognitive psychology principles well-explained and properly applied?",
"scores": {
"1": "No cognitive foundation - purely prescriptive rules without explanation",
"2": "Weak cognitive foundation - limited explanation of underlying principles",
"3": "Adequate cognitive foundation - basic principles explained",
"4": "Strong cognitive foundation - principles well-explained with research backing",
"5": "Exceptional cognitive foundation - deep principles, research citations, WHY clearly explained"
}
}
],
"threshold": 3.5,
"passing_note": "Average score must be ≥ 3.5 for skill to be considered production-ready. Scores below 3 in any individual criterion require revision before deployment."
}