Skills
Build reusable AI prompts that clean up, enhance, append to, or rewrite a note — and review every change as a diff.
A skill is a saved prompt you can run on a note. Write the instruction once — "pull out every commitment I made and who I made it to" — and run it on any note from then on.
Prismical ships a few skills to start with, and you can write your own.
What Comes Built In
Two skills run on a note from the dock:
| Skill | What it does |
|---|---|
| Cleanup | Fix grammar and formatting without changing your meaning. |
| Enhance | Turn the recording and your rough notes into a clean, structured summary. |
Enhance is the main recording-to-note action and has a page of its own.
Three more appear as suggestions in Ask AI rather than running on a single note: Summarize my notes, Find action items, and What did I decide?
Built-in skills are read-only. To adapt one, open it and choose Clone skill — you'll get an editable copy.
Running a Skill
There are three ways, and which ones a skill offers is set on the skill itself.
The wand button at the bottom of a note runs your default skill — click the chevron next to it to pick a different one, or to change the mode for this run.
While it works, the button reads Generating and offers a stop button.
Highlight text in a note and the popover lists every skill with the inline surface enabled. The skill rewrites just what you highlighted.
This only works on a selection inside a single block of text.
Skills with the Ask AI surface appear as one-tap suggestion chips in the Ask panel. Tapping one sends the skill's prompt as your question.
Here the skill is a saved question, not a note transformation — nothing is written back to the note.
Skills also run automatically when you stop a recording, if Auto-enhance after recording is on. See Enhance.
Reviewing the Result
Nothing is written to your note until you say so. When a skill finishes, the result appears as a diff at the bottom of the note with three choices:
| Accept | Apply the change to the note. |
| Refine | Give a follow-up instruction — "shorter", "keep the dates" — and run it again on the same input. |
| Reject | Throw it away and leave the note untouched. |
After you accept, a toast offers Undo for a moment, which restores the note to exactly what it was.
Undo covers the most recent accept only, and it restores the whole note body rather than picking out one change.
What a Skill Reads
Every skill reads the note's text. Beyond that:
- The transcript is included only if the skill asks for it. A skill that doesn't opt in can't see the transcript at all, which is what keeps a note-only skill from drifting into summarizing your recording.
- Your selection is what an inline skill rewrites.
- The note title is passed as context, but a note with a title and no body still counts as empty — you'll be told to add some content before running the skill.
Writing Your Own
Go to Settings → Skills and click Create skill.
Name it — this is what you'll see in the dock menu and on the skill card.
Add a Description. One short line, shown on the card.
Write the Prompt. This is the skill. The note — and the transcript, if the skill uses it — arrives as markdown; your prompt says what to do with it and what to send back.
Open Advanced settings to choose the mode and where the skill appears. The defaults are fine for most skills.
Click Create. It's available immediately.
Modes
The mode decides what happens to the note when you accept.
| Mode | Result |
|---|---|
| Append section | Adds the output to the end of the note. Leaves what's already there alone. |
| Replace document | Swaps the entire note body for the output. |
| Inline rewrite | Replaces just the highlighted selection. Only for skills on the inline surface. |
Append section is the safe default. Reach for Replace document when the skill's job is to produce the note rather than add to it.
Surfaces
A skill needs at least one:
| Surface | Where it shows up |
|---|---|
| Dock | The wand button at the bottom of a note. |
| Inline (highlight popover) | The popover that appears when you select text. |
| Ask AI (suggested prompt) | A suggestion chip in the Ask panel. |
Turning on the Ask AI surface adds an Ask AI scope choice: suggest this skill only when a note is open (good for "Summarize this note"), or everywhere (good for "Find action items across my notes").
Other settings
- Set as default sparkle target — makes this the skill the wand button runs.
- Mode-agnostic prompt — for prompts that shouldn't be adjusted to the mode.
- Enabled — turn a skill off without deleting it.
Giving a Skill Tools
Under Tools, you can grant a skill access to your connected integrations, so it can pull in a calendar event or file an issue as part of its run.
A skill with tools uses them without asking, unlike Ask AI, which asks before every tool call. Grant tools only to skills you wrote or trust.
Sharing Skills
Skills are personal — yours don't appear for your teammates. To pass one along, open it and choose Export as JSON, then have them use Import skill on the Skills screen.
Use JSON for this. Export as Markdown is for reading and editing a prompt outside Prismical — importing a Markdown file brings the prompt back but not the skill's name, description, or settings, so you'd have to set those up again.