Where things live
Where things live
Section titled “Where things live”Personal Cursor skills (on disk)
Section titled “Personal Cursor skills (on disk)”All skills are under ~/.cursor/skills/ (create the folder if it does not exist). Each skill is a directory with a SKILL.md file.
| Skill directory | Role |
|---|---|
~/.cursor/skills/sylva-github/ | Umbrella: routes you to the right focused skill and doc. |
~/.cursor/skills/sylva-pr-workflow/ | Branches, draft PRs, verification-first checklist. |
~/.cursor/skills/sylva-release-notes/ | GitHub Releases + links back to roadmap / docs. |
~/.cursor/skills/sylva-github-hygiene/ | Issue cleanup, legacy handling, repo tidiness. |
~/.cursor/skills/sylva-github-projects/ | GitHub Projects (v2): list projects, export board items, read:project + gh CLI. |
~/.cursor/skills/ship-ready-changes/ | Summary → your confirm → commit → push → pull --ff-only → clean tree. Snippet for global User Rules: USER-SETTINGS-SNIPPET.md in that folder. |
These files are not committed to sylva-docs; this handbook is the durable record of what they contain and how they interact.
Handbook (this site)
Section titled “Handbook (this site)”Built from the sylva-docs repository: src/content/docs/agent-workflows/. Published URLs (local dev or deployed) follow Starlight routes, e.g. /agent-workflows/workflow-index.
Roadmap (authoritative planning)
Section titled “Roadmap (authoritative planning)”Source: src/content/docs/roadmap/ in sylva-docs. Human-readable overview: Roadmap.
Repository map
Section titled “Repository map”Which GitHub repo owns what: Repositories and workspace map.
GitHub (operations)
Section titled “GitHub (operations)”Use the GitHub web UI or the gh CLI (brew install gh; gh auth login) for PRs, releases, labels, and archiving. The handbook describes what to do; tooling choice is yours.