Create, refactor, and package reusable agent skills
A meta-skill for creating, refactoring, evaluating, and packaging agent skills from workflows, prompts, transcripts, docs, or notes.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Transform workflows, prompts, transcripts, and documentation into production-ready, team-distributable agent skills with evaluation gates, governance controls, and standardized packaging.
Outcomes
What it gets done
Scaffold new skills from user workflows or notes with lean structure and routing rules
Evaluate skill quality through output contracts, trust reports, and conformance gates
Package skills for team reuse with governance boundaries and rollback contracts
Refactor existing skills across operating modes from exploratory to governed release
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/ag-yao-meta-skill | bash Overview
Yao Meta Skill
A meta-skill for creating, refactoring, evaluating, and packaging agent skills from workflows, prompts, transcripts, docs, or notes, scaled across four operating modes. Use when creating, improving, evaluating, or packaging a reusable agent skill, from a personal scaffold up to a governed, team-distributed release.
What it does
Yao Meta Skill creates, refactors, evaluates, and packages agent skills from workflows, prompts, transcripts, docs, or notes - covering skill creation, reusable workflow packaging, skill improvement, evals, and team-ready distribution. It routes by frontmatter description and keeps SKILL.md lean, pushing guidance into references/, logic into scripts/, and evidence into reports/, always favoring the lightest reliable process.
When to use - and when NOT to
Use it when the request matches creating, refactoring, evaluating, or packaging a reusable agent skill. For a one-off task with no reusable process, the compact workflow's first step is explicit: do not create a skill - check for a near-neighbor skill first, and only proceed if there's genuinely repeated use plus a reusable output contract.
Inputs and outputs
It defines four operating modes of increasing rigor - Scaffold (exploratory/personal), Production (team reuse), Library (shared infrastructure), and Governed (high-trust, policy-sensitive, or release-critical) - governed by dedicated Method, Operating Modes, and Resource Boundaries reference docs. Its compact workflow captures the job, output, exclusions, constraints, and standards; scans external benchmark, user source, and local-fit references in that order, surfacing only genuine uncertainty or conflict; writes the description early and tests route quality before adding folders or gates; and layers in output-risk, artifact-design, prompt-quality, system-model, or next-directions guidance only when useful. Unless told otherwise, the output contract is SKILL.md, an aligned agents/interface.yaml, justified supporting assets, and a short summary of boundary, exclusions, gates, and next steps.
# agents/interface.yaml is produced alongside SKILL.md
Integrations
For Production, Library, Governed, or team-distributed work, it runs a Skill OS 2.0 gate chain before release - Skill IR, target compiler, trigger and output eval, Skill Atlas, conformance, trust, registry/package/install, upgrade, drift, waiver, and Review Studio. For file-backed, release-critical, or governed packages it requires an owner, review cadence, input_files framed as file-backed fixture evidence, an output contract, and a rollback boundary, plus a trust report and reports/output_quality_scorecard.md - explicitly marking any unavailable telemetry, approvals, metrics, or benchmarks as missing evidence rather than fabricating it. Its first-turn style starts from the user's actual work or outcome before structure, asks only 2-3 key questions unless enough detail already exists, and in Chinese adopts a soft, companion-like tone via a dedicated Intent Dialogue reference.
Who it's for
Teams and individuals who need to turn ad hoc workflows, prompts, transcripts, or notes into properly scoped, evaluated agent skills - scaling the process from a quick personal scaffold up to a governed, audit-ready package with evidence and rollback boundaries when the stakes require it.
Source README
Yao Meta Skill
When to Use
Use when this workflow matches the user request: Create, refactor, evaluate, and package agent skills from workflows, prompts, transcripts, docs, or notes. Use for skill creation, reusable workflow packaging, skill improvement, evals, and team-ready distribution.
Source: yaojingang/yao-meta-skill (MIT).
Router Rules
- Route by frontmatter
description. - Keep
SKILL.mdlean; put guidance inreferences/, logic inscripts/, and evidence inreports/. - Use the lightest reliable process.
Modes
Scaffold: exploratory/personal.Production: team reuse.Library: shared infrastructure.Governed: high-trust, policy-sensitive, or release-critical.- Rules: Method, Operating Modes, Resource Boundaries.
Compact Workflow
- For one-off/no reusable process:
Do not create a skill;near-neighbor; requirerepeated use+reusable output contract. - Capture job, output, exclusions, constraints, standards, and the lightest fit.
- Scan references in order: external benchmark, user source, local fit; surface only uncertainty or conflict.
- Write
descriptionearly, test route quality, then add only earned folders and gates. - Add output-risk, artifact-design, prompt-quality, system-model, and next directions only when useful.
Playbooks: Method, Intent, Skill IR, Output Eval, Review Studio.
Skill OS 2.0 Gates
For production, library, governed, or team-distributed work, run Skill IR, target compiler, trigger + output eval, Skill Atlas, conformance, trust, registry/package/install, upgrade, drift, waiver, and Review Studio gates before release.
Governed Package Boundary
For file-backed, release-critical, or governed packages, name input_files as file-backed fixture evidence; include owner, review cadence, input_files, output contract, rollback boundary; require trust report and reports/output_quality_scorecard.md; mark unavailable telemetry, approvals, metrics, or benchmarks as missing evidence; do not fabricate evidence.
Preserve audit labels literally when they apply: file-backed fixture, input_files, output contract, rollback boundary, trust report, reports/output_quality_scorecard.md, missing evidence.
First-Turn Style
- Start from the user's work/outcome before structure.
- Ask only
2-3key questions unless enough detail exists. - In Chinese, sound soft and companion-like; use Intent Dialogue.
Output Contract
Unless asked otherwise, produce SKILL.md, aligned agents/interface.yaml, justified assets, and a short summary of boundary, exclusions, gates, and next steps.
Reference Map
Primary: Method, Artifact Design, Systems Thinking, Governance, SkillOps Decision.
Limitations
- Requires the upstream tool, account, API key, or local setup when the workflow names one.
- Does not authorize destructive, production, paid, or external-message actions without explicit user approval.
- Validate generated artifacts or recommendations against the user's real sources before treating them as final.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.