Documentation
AI
Slash Commands

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

CommandOutput artifactDefault note colour
/generate-prdProduct Requirements Document (overview, goals, user stories)Blue
/generate-epicEpic with constituent stories and dependenciesOrange
/generate-storyUser story with Given/When/Then acceptance criteriaYellow
/generate-decisionADR-style decision recordPurple
/generate-feedbackFeedback summary with themesBlue
/generate-dev-taskTechnical development task with implementation stepsYellow
/generate-qa-testQA test plan with scenarios and test casesGreen

How to use them

  1. Open a note in the editor overlay.
  2. 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
  1. Hit Enter. The AI streams the generated artifact into the note.
  2. 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-Flow

The #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

  1. Create lib/ai/skills/generate-{name}/SKILL.md with the YAML frontmatter above.
  2. Add the command metadata to the SLASH_COMMANDS registry in lib/ai/commands.ts.
  3. The new command will be available in autocomplete and via POST /api/canvas/note-ai/{name}.
  4. 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