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

  1. Identify changes: Read the source doc(s) in www/content/docs/. If input is a diff, extract only changed sections.
  2. 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.
  3. Diff: Compare source doc content against skill coverage.
  4. Apply delta: Update only the sections that changed. Do NOT rewrite unchanged sections.
Related skills

More from udecode/better-convex

Installs
1
GitHub Stars
390
First Seen
Mar 30, 2026