{
  "context": "Tests whether the agent applies the Diataxis documentation framework correctly when restructuring mixed documentation content. The skill prescribes four distinct document types with specific title patterns, structural rules, and cross-linking requirements.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Four doc types present",
      "description": "Output contains at least one document of each Diataxis type: tutorial, how-to guide, reference, and explanation",
      "max_score": 10
    },
    {
      "name": "Tutorial title starts with verb",
      "description": "The tutorial document's title begins with an imperative verb (e.g., 'Build', 'Create', 'Set up', 'Write')",
      "max_score": 10
    },
    {
      "name": "How-to title is task-framed",
      "description": "The how-to guide document's title starts with 'How to' or is phrased as a task (e.g., 'How to configure X')",
      "max_score": 10
    },
    {
      "name": "Reference entry format",
      "description": "The reference document uses a consistent per-entry format that includes at least: name, type/default, description, and an example for each parameter or option",
      "max_score": 10
    },
    {
      "name": "Explanation title is concept-framed",
      "description": "The explanation document's title frames a concept (e.g., 'How X works', 'Understanding Y', 'Why Z is designed this way')",
      "max_score": 10
    },
    {
      "name": "Single type per document",
      "description": "No individual output document mixes documentation types (e.g., tutorial steps do NOT appear alongside reference tables in the same file)",
      "max_score": 10
    },
    {
      "name": "Tutorial has numbered steps",
      "description": "The tutorial document uses numbered steps and each step produces an observable action or result",
      "max_score": 10
    },
    {
      "name": "How-to skips background theory",
      "description": "The how-to guide does NOT include conceptual explanations or background theory — it goes directly to prerequisites and steps",
      "max_score": 10
    },
    {
      "name": "Cross-links between types",
      "description": "At least one document contains a cross-reference link to a document of a different Diataxis type (e.g., tutorial links to reference, or how-to links to explanation)",
      "max_score": 10
    },
    {
      "name": "Reference avoids instructions",
      "description": "The reference document states facts (parameters, types, defaults, examples) without including numbered instructional steps",
      "max_score": 10
    }
  ]
}