{
  "summary": {
    "skill_name": "yao-meta-skill",
    "description": "Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use when asked to create a skill, turn a repeated process into a reusable skill, improve an existing skill, add evals, or package a skill for team reuse.",
    "maturity_tier": "governed",
    "selection_rule": "Pick the three smallest next steps that increase reliability more than they increase context cost.",
    "recommended_now": "Borrow one proven pattern on purpose",
    "recommended_now_why": "You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.",
    "defer_for_now": "Create an iteration evidence loop"
  },
  "directions": [
    {
      "priority": 2,
      "title": "Borrow one proven pattern on purpose",
      "why": "You already have public benchmark objects. The next gain is to choose one pattern intentionally instead of absorbing everything loosely.",
      "actions": [
        "Read the strongest pattern from obra/superpowers.",
        "Decide whether to borrow method, structure, execution, or portability, but only one of them first.",
        "Record what you will not borrow so the package stays light."
      ],
      "unlocks": "A cleaner package shape with less accidental over-design.",
      "do_now": "Do this first.",
      "wait_on": "Wait to add broader structure until this move clearly improves reliability."
    },
    {
      "priority": 5,
      "title": "Harden portability semantics",
      "why": "The skill already signals reuse across environments, so contract clarity matters early.",
      "actions": [
        "Confirm activation mode, execution context, and trust assumptions.",
        "Add or review degradation strategy for non-native targets.",
        "Package the skill once to verify adapter expectations."
      ],
      "unlocks": "Safer cross-environment reuse with less target drift.",
      "do_now": "Do this after the first move lands cleanly.",
      "wait_on": "Wait until the package has evidence that this extra structure is justified."
    },
    {
      "priority": 12,
      "title": "Create an iteration evidence loop",
      "why": "The package should show what changed and why after the first draft.",
      "actions": [
        "Generate the HTML skill report and keep it aligned with the package.",
        "Record reference scan choices and non-goals.",
        "Capture the next iteration choice explicitly before adding more files."
      ],
      "unlocks": "A clearer path for the next author or reviewer.",
      "do_now": "Do this after the first move lands cleanly.",
      "wait_on": "Wait until the package has evidence that this extra structure is justified."
    }
  ]
}