yao-open-skills-sync

1# Yao Open Skills Sync
2 
3Use this skill to manage the public `yao-open-skills` collection in the current repo root.
4 
5This skill is not for creating arbitrary new skills from scratch. It is for intake, governance, sync tracking, and collection maintenance.
6 
7## Read First
8 
9Before changing the collection, read:
10 
11- `references/operating-rules.md`
12- `references/registry-schema.md`
13 
14Only read repo-wide docs under `../../docs/` if you need more human-facing detail after reviewing the references.
15 
16## Primary Responsibilities
17 
18- Evaluate whether a local skill is suitable for public release
19- Create a clean public copy under `skills/<slug>/`
20- Register or update the skill in `registry/skills.json`
21- Add or update a human-facing usage guide under `docs/skills/<slug>.md`
22- Regenerate the README catalog and HTML navigation page so the collection homepage stays in sync
23- Record whether the skill is only local, staged, published, or needs an update
24- Push collection changes to GitHub when the user wants the public repo updated
25 
26## Workflow
27 
28### 1. Inspect the source skill
29 
30Given a local path from the user:
31 
32- Confirm the path exists
33- Inspect `SKILL.md`
34- Identify what should be kept, removed, or rewritten for public release
35 
36Watch for:
37 
38- `output/`, `downloads/`, `.venv/`, `node_modules/`, caches, logs
39- generated reports, exported results, `.command` helpers, and local scan artifacts
40- private APIs, tokens, cookies, internal references, customer data
41…