.cursor/skills/vom-new/SKILL.md
Guide for creating a new VOM ticket using the vom CLI so tickets are good-quality and workflow-aligned.
npx skillsauth add denerose/VeganMealPlanner vom-newInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
When the user asks to create a new ticket (or uses /vom-new), follow these steps so the new ticket is high-quality and fits the project's VOM workflow.
If you are not already familiar with this project's VOM workflow, run:
vom --agents-help
Use that output to align with: claim → guidance → show → work → next, single-step per state, and acceptance criteria. New tickets should fit that workflow.
Title: Short, imperative, scoped to one workflow step or deliverable (e.g. "add X", "fix Y when Z", "document W").
Description: When useful, 1–3 sentences for context, constraint, or outcome so triage and planning have enough to set type, priority, and acceptance criteria. Use vom new "<title>" "<description>" or --file path for longer text.
Type and priority: Use vom new -t <type> -p <priority> "title" when obvious (e.g. -t bug -p critical for a critical bug); otherwise leave default and let triage set them.
Workflow fit: Tickets should be small enough for the single-step agent workflow (one state transition per agent run). If the user's request is large, suggest splitting into multiple tickets or a single ticket that will be broken down in planning—do not create one oversized ticket.
Run:
vom new "<title>"
Add optional description, type, or priority as above. For large or vague requests, suggest splitting or a planning breakdown before running vom new.
Examples:
vom new "add search to vom list"
vom new "fix login when session expired" "Users get 500 after session timeout; should redirect to login."
vom new -t bug -p critical "crash on empty input"
Confirm the created ticket ID from the command output, then suggest the next step:
vom claim TKT-006 when ready to work it."Run vom --agents-help first if unsure about the workflow. This keeps new tickets consistent with claim → guidance → show → work → next and good-quality title/description/type/priority.
testing
Guide for continuing work on a VOM ticket - reminds agents to claim and check guidance before starting.
data-ai
Move VOM tickets with state done or deleted into tickets/done or tickets/deleted to keep the main list tidy.
testing
Review recent work for friction and pain points. Create or update tickets for issues that made the agent's job harder. Focus on project-specific improvements only.
tools
Reviews, amends, and improves a VOM implementation plan for a ticket in plan-needs-review using only the vom CLI for claims, guidance, comments, and state transitions; edits plan markdown under plans/ only. Use when the user wants a plan approved (moved to plan-approved), wants plan-needs-review handled end-to-end, or invokes plan review with extra notes or constraints in the prompt.