Project skills

Agent skills in this directory are available to Cursor in this repo. Each skill is a folder with a SKILL.md (required) and optional support files.

Skill	When to use
add-book-to-buckyverse	Copying a manuscript/source book into `buckyverse2/priv/books/<book_slug>` for buckyverse2.
pdf-to-wikijs-markdown	OCRing PDFs and turning them into WikiJS markdown pages for the wiki archive.
git-town	Creating a feature branch (`hack`), syncing with main (`sync`), or shipping/merging to main (`ship`). Use when the user says "git town", "hack", "sync", "ship", "create branch", "merge branch", or "feature branch".
xp_work	Recording feedback, todos, bugs, user goals; managing iteration work; marking done; committing completed work; moving items to acceptance. Use prefixes like `improve:`, `feat:`, `todo:`, `bug:`, `goal:`, `add to iteration:`, `done:`, `work complete:`, `needs acceptance:`.
buckyverse-book-synthesis	Compile Fuller book directories into repeatable llm-wiki synthesis pages.

Layout

.cursor/skills/
├── README.md                    # This file
├── add-book-to-buckyverse/
│   ├── SKILL.md
│   └── reference.md
├── git-town/
│   ├── SKILL.md
│   └── USAGE.md
├── buckyverse-book-synthesis/
│   └── SKILL.md
└── xp_work/
    ├── SKILL.md
    ├── USAGE.md
    └── assets/                  # Templates for work tracking
        ├── acceptance-template.md
        ├── bug-template.md
        ├── feedback-template.md
        ├── iteration-template.md
        ├── todo-template.md
        └── user-goal-template.md

Quick triggers

Book source copy: "add book to buckyverse", "deploy to buckyverse2", "copy to buckyverse2/priv/books"
PDF → wiki markdown: "OCR a PDF", "create markdown from a PDF", "process documents for the wiki"
Branches: git town hack <name>, git town sync, git town ship
Work tracking: improve: …, feat: …, todo: …, bug: …, goal: …, add to iteration: …, done: …, work complete: …, needs acceptance: …

Disambiguation

Use add-book-to-buckyverse only for copying manuscript/source files into buckyverse2/priv/books/.
Use pdf-to-wikijs-markdown only for converting PDFs into wiki markdown; do not use it to copy book source trees.
Use xp_work only to record/manage work items; it does not implement code changes.
Use git-town only for branch lifecycle commands.