sync-skill
Installation
SKILL.md
Task
Sync recent doc changes into skills/convex/ so the skill stays current.
Input: $ARGUMENTS (doc file path, PR diff, or "all" to scan for drift)
Skill layout
SKILL.md— essentials (~80-90% of e2e feature work: cRPC, ORM, auth, React)references/— setup guides (one-time bootstrap) and advanced features (aggregates, scheduling, rate limiting, etc.)
Routing rule: If the changed doc covers a topic already in SKILL.md → update SKILL.md. If it covers setup or an advanced/niche feature → update or create the matching reference file.
Process
- Identify changes: Read the source doc(s) in
www/content/docs/. If input is a diff, extract only changed sections. - Read target: Read SKILL.md and scan
references/to find where the topic lives. Note: skill files are compressed for machine consumption — they won't match docs verbatim. - Diff: Compare source doc content against skill coverage.
- Apply delta: Update only the sections that changed. Do NOT rewrite unchanged sections.