{
  "skill_name": "geo-content-brief-skill",
  "risk_families": [
    {
      "key": "markdown_readability",
      "label": "Markdown readability",
      "matched_keywords": [
        "md",
        "table",
        "report",
        "brief"
      ],
      "score": 4,
      "risks": [
        "Tables can render as dense grids with weak hierarchy or poor mobile readability.",
        "Long bullets can make the output look complete while hiding the actual decision logic.",
        "Mixed heading levels can reduce scanability."
      ],
      "constraints": [
        "Use tables only when comparison is the main job; otherwise prefer compact cards or grouped bullets.",
        "Keep table cells short and move explanations below the table.",
        "Use heading levels consistently and keep each section anchored to a user-facing outcome."
      ],
      "self_repair": [
        "Preview whether each table still reads well when columns are narrow.",
        "Convert any table with paragraph-length cells into bullets or cards."
      ]
    },
    {
      "key": "visual_capture",
      "label": "Screenshot and visual capture",
      "matched_keywords": [
        "screenshot",
        "visual",
        "screen"
      ],
      "score": 3,
      "risks": [
        "Screenshots can be captured from the wrong state, wrong viewport, or wrong crop.",
        "Missing screenshots can cause the skill to invent visual references instead of declaring the gap.",
        "Image descriptions can omit the action-relevant region."
      ],
      "constraints": [
        "Never invent a screenshot; state when visual evidence is missing.",
        "Record the source, viewport, and crop intent for any screenshot-dependent output.",
        "Describe what the reader should inspect in the image, not just that an image exists."
      ],
      "self_repair": [
        "Check that every screenshot reference points to a real provided or generated asset.",
        "Reword any visual instruction that depends on an unseen screen state."
      ]
    },
    {
      "key": "citation_clutter",
      "label": "Citation and footnote clutter",
      "matched_keywords": [
        "citation",
        "reference"
      ],
      "score": 2,
      "risks": [
        "Footnote markers or dense citation notes can interrupt the reading flow.",
        "Evidence can be over-attached to obvious statements and under-attached to risky claims.",
        "Source notes may become more prominent than the tutorial itself."
      ],
      "constraints": [
        "Attach citations only to claims that need evidence, not to every sentence.",
        "Group source notes at the end of a section when inline markers would hurt readability.",
        "Keep the main sentence readable without requiring the reader to chase a footnote."
      ],
      "self_repair": [
        "Remove decorative citations that do not support a material claim.",
        "Move repeated source explanations into one compact source note."
      ]
    },
    {
      "key": "tone_and_specificity",
      "label": "Tone and specificity",
      "matched_keywords": [
        "copy",
        "content"
      ],
      "score": 2,
      "risks": [
        "Headings and summaries can drift into generic, interchangeable language.",
        "The output can sound polished but lose the user's actual taste, audience, or scenario.",
        "Strong claims can appear without examples or constraints."
      ],
      "constraints": [
        "Anchor titles and summaries in the user's audience, object, and concrete outcome.",
        "Avoid placeholder phrases such as comprehensive guide, ultimate solution, or key insights unless the source demands them.",
        "Preserve one distinctive phrase, constraint, or standard from the user's input."
      ],
      "self_repair": [
        "Replace generic title candidates with scenario-specific alternatives.",
        "Delete any polished sentence that could fit almost any project unchanged."
      ]
    },
    {
      "key": "tutorial_quality",
      "label": "Tutorial quality",
      "matched_keywords": [
        "tutorial"
      ],
      "score": 1,
      "risks": [
        "Generic section headings make the tutorial feel templated instead of fitted to the learner's task.",
        "Steps may explain what to do without naming the exact check that proves the step worked.",
        "Examples can become too abstract when the input material is concrete."
      ],
      "constraints": [
        "Write headings from the user's domain nouns and desired outcome, not from generic labels like Overview or Key Points.",
        "Pair each major step with a visible success check or expected intermediate output.",
        "Use one concrete worked example before adding broad principles."
      ],
      "self_repair": [
        "Replace generic H2/H3 headings with task-specific headings before final output.",
        "Scan every numbered step for a missing verification cue."
      ]
    }
  ],
  "top_risks": [
    "Tables can render as dense grids with weak hierarchy or poor mobile readability.",
    "Long bullets can make the output look complete while hiding the actual decision logic.",
    "Screenshots can be captured from the wrong state, wrong viewport, or wrong crop.",
    "Missing screenshots can cause the skill to invent visual references instead of declaring the gap.",
    "Footnote markers or dense citation notes can interrupt the reading flow.",
    "Evidence can be over-attached to obvious statements and under-attached to risky claims."
  ],
  "output_constraints": [
    "Use tables only when comparison is the main job; otherwise prefer compact cards or grouped bullets.",
    "Keep table cells short and move explanations below the table.",
    "Never invent a screenshot; state when visual evidence is missing.",
    "Record the source, viewport, and crop intent for any screenshot-dependent output.",
    "Attach citations only to claims that need evidence, not to every sentence.",
    "Group source notes at the end of a section when inline markers would hurt readability."
  ],
  "self_repair_checks": [
    "Preview whether each table still reads well when columns are narrow.",
    "Convert any table with paragraph-length cells into bullets or cards.",
    "Check that every screenshot reference points to a real provided or generated asset.",
    "Reword any visual instruction that depends on an unseen screen state.",
    "Remove decorative citations that do not support a material claim.",
    "Move repeated source explanations into one compact source note."
  ],
  "reviewer_note": "Use this report before deepening the package and again before approving example outputs."
}
