Slash Commands
What they are
Slash commands are predefined AI generation skills, each backed by a focused system prompt. They generate structured PM artifacts inside a note.
Available commands
| Command | Output artifact | Default note colour |
|---|---|---|
/generate-prd | Product Requirements Document (overview, goals, user stories) | Blue |
/generate-epic | Epic with constituent stories and dependencies | Orange |
/generate-story | User story with Given/When/Then acceptance criteria | Yellow |
/generate-decision | ADR-style decision record | Purple |
/generate-feedback | Feedback summary with themes | Blue |
/generate-dev-task | Technical development task with implementation steps | Yellow |
/generate-qa-test | QA test plan with scenarios and test cases | Green |
How to use them
- Open a note in the editor overlay.
- In the AI prompt bar at the bottom, type the slash command, optionally with context:
/generate-prd based on the notes tagged Epic and the Feedback note- Hit Enter. The AI streams the generated artifact into the note.
- The note's colour is automatically set to the command's
defaultColor.
Autocomplete
Typing / in the prompt bar opens a command autocomplete dropdown. Use arrow keys to navigate and Tab or Enter to select.
Adding note context with hashtags
Reference other notes directly in your command:
/generate-story based on #User-Research-Themes and #Epic-Activation-FlowThe #Note-Title syntax resolves to the matching note by title (case-insensitive, hyphens → spaces) and injects its content into the prompt.
Skill architecture
Each slash command is backed by a SKILL.md file containing:
---
name: generate-prd
description: Generate a PRD with overview, goals, and user stories
defaultColor: blue
---
(Markdown system prompt body follows)The Markdown body becomes the AI system prompt for that command. Skills are imported at build time via a webpack asset/source rule — no runtime file reads needed.
Adding a new command
- Create
lib/ai/skills/generate-{name}/SKILL.mdwith the YAML frontmatter above. - Add the command metadata to the
SLASH_COMMANDSregistry inlib/ai/commands.ts. - The new command will be available in autocomplete and via
POST /api/canvas/note-ai/{name}. - Update this page with the new command and its output description.
See also
- Note AI — Free-form note authoring and streaming contract
- Code Standards — How to contribute a new skill