yao-meta-skill/reports/reference-synthesis.json

{
  "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.",
  "intent_confidence": {
    "score": 100,
    "band": "high",
    "gate_passed": true
  },
  "github_benchmarks": [
    {
      "name": "obra/superpowers",
      "url": "https://github.com/obra/superpowers",
      "stars": 226125,
      "borrow": [
        "Borrow the way it turns a messy workflow into a repeatable operating path.",
        "Borrow the clear execution entrypoints and command structure."
      ]
    },
    {
      "name": "affaan-m/ECC",
      "url": "https://github.com/affaan-m/ECC",
      "stars": 214381,
      "borrow": [
        "Borrow the way it turns a messy workflow into a repeatable operating path.",
        "Borrow the clear execution entrypoints and command structure."
      ]
    },
    {
      "name": "multica-ai/andrej-karpathy-skills",
      "url": "https://github.com/multica-ai/andrej-karpathy-skills",
      "stars": 174264,
      "borrow": [
        "Borrow explicit validation and quality gates that make iteration safer.",
        "Borrow the way it separates explanation, examples, and reusable structure."
      ]
    }
  ],
  "source_tracks": [
    {
      "source_type": "official",
      "name": "Official skill anatomy and context discipline",
      "evidence_mode": "curated-pattern-track",
      "matched_keywords": [
        "metadata",
        "references"
      ],
      "borrow": "Borrow progressive disclosure: keep the entrypoint lean and move depth into references or scripts.",
      "avoid": "Do not let packaging or platform concerns swallow the core job boundary.",
      "why_relevant": "This track matches: metadata, references."
    },
    {
      "source_type": "research",
      "name": "Human-in-the-loop verification",
      "evidence_mode": "curated-pattern-track",
      "matched_keywords": [
        "review",
        "govern"
      ],
      "borrow": "Borrow a review checkpoint wherever trust matters more than raw speed.",
      "avoid": "Do not force every skill through heavyweight review when the risk is low.",
      "why_relevant": "This track matches: review, govern."
    },
    {
      "source_type": "principles",
      "name": "Boundary-first design",
      "evidence_mode": "curated-pattern-track",
      "matched_keywords": [
        "route"
      ],
      "borrow": "Borrow the discipline of defining what the skill should not own before growing the package.",
      "avoid": "Do not expand execution assets until route boundaries stay clean.",
      "why_relevant": "This track matches: route."
    }
  ],
  "synthesis": {
    "borrow_now": [
      "Borrow progressive disclosure: keep the entrypoint lean and move depth into references or scripts.",
      "Borrow a review checkpoint wherever trust matters more than raw speed.",
      "Borrow the discipline of defining what the skill should not own before growing the package.",
      "Borrow the way it turns a messy workflow into a repeatable operating path.",
      "Borrow the clear execution entrypoints and command structure."
    ],
    "avoid_now": [
      "Do not let packaging or platform concerns swallow the core job boundary.",
      "Do not force every skill through heavyweight review when the risk is low.",
      "Do not expand execution assets until route boundaries stay clean.",
      "Do not import process overhead that only exists for that project's scale.",
      "Do not copy repo-specific commands or environment assumptions verbatim."
    ],
    "quality_risers": [
      "Use GitHub repositories for concrete package and workflow patterns.",
      "Use curated official or commercial tracks for entrypoint and operator ergonomics.",
      "Use research tracks to justify the smallest evaluation loop that still catches regressions.",
      "Use principle tracks to keep the package small, boundary-aware, and outcome-driven."
    ],
    "pattern_gate": {
      "threshold": 4,
      "source_count": 6,
      "accepted": [
        {
          "name": "Official skill anatomy and context discipline",
          "source_type": "official",
          "borrow": "Borrow progressive disclosure: keep the entrypoint lean and move depth into references or scripts.",
          "avoid": "Do not let packaging or platform concerns swallow the core job boundary.",
          "gates": {
            "recurrence": true,
            "generativity": true,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "generativity",
            "distinctiveness",
            "boundary"
          ],
          "missing": [],
          "score": 4
        },
        {
          "name": "Human-in-the-loop verification",
          "source_type": "research",
          "borrow": "Borrow a review checkpoint wherever trust matters more than raw speed.",
          "avoid": "Do not force every skill through heavyweight review when the risk is low.",
          "gates": {
            "recurrence": true,
            "generativity": true,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "generativity",
            "distinctiveness",
            "boundary"
          ],
          "missing": [],
          "score": 4
        },
        {
          "name": "Boundary-first design",
          "source_type": "principles",
          "borrow": "Borrow the discipline of defining what the skill should not own before growing the package.",
          "avoid": "Do not expand execution assets until route boundaries stay clean.",
          "gates": {
            "recurrence": true,
            "generativity": true,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "generativity",
            "distinctiveness",
            "boundary"
          ],
          "missing": [],
          "score": 4
        },
        {
          "name": "obra/superpowers",
          "source_type": "github",
          "borrow": "Borrow the way it turns a messy workflow into a repeatable operating path.; Borrow the clear execution entrypoints and command structure.",
          "avoid": "Do not import process overhead that only exists for that project's scale.",
          "gates": {
            "recurrence": true,
            "generativity": true,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "generativity",
            "distinctiveness",
            "boundary"
          ],
          "missing": [],
          "score": 4
        },
        {
          "name": "affaan-m/ECC",
          "source_type": "github",
          "borrow": "Borrow the way it turns a messy workflow into a repeatable operating path.; Borrow the clear execution entrypoints and command structure.",
          "avoid": "Do not import process overhead that only exists for that project's scale.",
          "gates": {
            "recurrence": true,
            "generativity": true,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "generativity",
            "distinctiveness",
            "boundary"
          ],
          "missing": [],
          "score": 4
        }
      ],
      "deferred": [
        {
          "name": "multica-ai/andrej-karpathy-skills",
          "source_type": "github",
          "borrow": "Borrow explicit validation and quality gates that make iteration safer.; Borrow the way it separates explanation, examples, and reusable structure.",
          "avoid": "Do not clone heavyweight evaluation scaffolding if a lighter gate is enough here.",
          "gates": {
            "recurrence": true,
            "generativity": false,
            "distinctiveness": true,
            "boundary": true
          },
          "passed": [
            "recurrence",
            "distinctiveness",
            "boundary"
          ],
          "missing": [
            "generativity"
          ],
          "score": 3
        }
      ],
      "summary": "5 accepted, 1 deferred using threshold 4/4."
    },
    "conflicts": [
      {
        "key": "lightweight_vs_governance",
        "summary": "The stated preference leans lightweight or speed-first, while the benchmark mix leans toward governance, review, or heavier evaluation structure.",
        "user_preference": "lightweight or speed-first",
        "benchmark_pressure": "governance or evaluation-heavy patterns"
      }
    ],
    "recommendation": {
      "summary": "Start by borrowing this pattern: Borrow progressive disclosure: keep the entrypoint lean and move depth into references or scripts. Avoid this for the first pass: Do not let packaging or platform concerns swallow the core job boundary.",
      "borrow_now": [
        "Borrow progressive disclosure: keep the entrypoint lean and move depth into references or scripts.",
        "Borrow a review checkpoint wherever trust matters more than raw speed."
      ],
      "avoid_for_now": [
        "Do not let packaging or platform concerns swallow the core job boundary.",
        "Do not force every skill through heavyweight review when the risk is low."
      ],
      "why": "There is a real design conflict to resolve: The stated preference leans lightweight or speed-first, while the benchmark mix leans toward governance, review, or heavier evaluation structure.",
      "user_decision_required": true
    },
    "visibility": {
      "mode": "explicit",
      "user_decision_required": true,
      "reasons": [
        "design_conflict"
      ],
      "user_note": "Surface the recommendation because intent is still settling or there is a real design conflict that needs a user call.",
      "reviewer_note": "Keep the full benchmark and synthesis evidence visible for authors and reviewers."
    },
    "decision_prompt": "Use the recommendation by default. Only surface the underlying benchmark tradeoffs when intent is uncertain or a real design conflict needs a deliberate call.",
    "source_mix": {
      "github_benchmarks": 3,
      "curated_tracks": 3,
      "user_references": 0
    }
  }
}