Static prompts, dynamic prompts and documents
Understand the three kinds of prompt, how each one behaves when a block changes, how a Skill fits in, and how to write and edit each one.
Want a hand?
Copy this prompt into Claude, ChatGPT or another AI assistant, and it walks you through it step by step.
I'm not sure whether to save my PromptMason prompts as static or dynamic, or when to use a Markdown document or a Skill. Explain the difference using my own work as the example, and help me choose.
Copy adds a short note about PromptMason and this guide's steps, so the assistant has what it needs.
I'm not sure whether to save my PromptMason prompts as static or dynamic, or when to use a Markdown document or a Skill. Explain the difference using my own work as the example, and help me choose. About PromptMason: a desktop app for Windows and Mac for building AI prompts from reusable blocks. A person writes blocks (reusable pieces of prompt text), builds prompts from them on the Build screen (or writes a Skill for an AI app, or keeps a Markdown document), and copies a prompt into an AI tool, runs it in PromptMason’s own Chat, or lets a connected AI agent use it through PromptMason’s built-in MCP server (the Chrome extension copies prompts on any website). AI assist, Evaluate and Chat use a local model that runs on the person’s computer, or their own AI provider. The guides are also on PromptMason’s Help screen, and Chat can answer “how do I” questions from them. Libraries hold the blocks and prompts; a person can sync their personal library to their other computers and share team libraries, both through a folder in cloud storage they already have (OneDrive, Google Drive or Dropbox). Everything synced is encrypted and every edit is signed and checked. A recovery kit (a file plus a code) is the spare copy of the person’s keys, for when every computer is lost. The official guide for this is "Static prompts, dynamic prompts and documents": https://promptmason.ai/docs/static-and-dynamic Its full text follows, between the lines. Use it as the source of truth, and if anything I see differs from it, tell me rather than guessing. --- Everything on the Prompts screen is one of three kinds: a dynamic prompt, a static prompt or a document. The kind decides where the words come from and how you edit the item. You choose it when you make the item. A dynamic or static prompt can also be a Skill (see [Kind and Category](#kind-and-category)). ## The three kinds | Kind | What it is | When a block changes | Edited on | |---|---|---|---| | **Dynamic** | A list of blocks, in order. Its text is put together from the blocks each time you use it. | The prompt changes too. | The Build screen | | **Static** | Fixed text. | Nothing happens to it. | The Prompts screen, or for a Skill its own editor screen | | **Document** | A Markdown document, kept exactly as written. | Nothing (it has no blocks). | The document editor screen | In List view, the **Kind** column says **Dynamic Prompt**, **Static Prompt**, **Static Skill**, **Dynamic Skill**, **Document** or **Prompt set**. Tile view and the pane on the right show the same kind as a badge. ## Dynamic prompts A dynamic prompt is built from library blocks on the Build screen ([Build a prompt](https://promptmason.ai/docs/build-prompt)). It stores which blocks it uses, in what order, and with which [block headers](https://promptmason.ai/docs/text-formatting#block-headers), not the text itself. Because of that, when you change a block, every dynamic prompt that uses it shows the new text the next time you view or copy it. Fix a typo in your "Role" block once, and all your prompts get the fix. What happens when a block is removed: - **Archived:** the block's text still goes into the prompt, and the block is marked **Archived**. To leave it out, open the prompt in Build and take the block out. - **Deleted:** the prompt shows `[Block removed: name]` in its place, with a warning, until you take it out of the prompt or the block is restored from **Recently deleted**. See [Archive, delete and restore](https://promptmason.ai/docs/archive-and-delete). Use a dynamic prompt when you want your prompts to stay in step with your blocks. That's most of the time. ## Static prompts A static prompt is fixed text. You get one in two ways: - **Save as Static** on the Build screen. The blocks' text, with its headers, is saved as one piece of text. From then on the prompt has no link to the blocks: changing or deleting a block doesn't change it. - **Write it yourself** on the Prompts screen (see [Write a static prompt](#write-a-static-prompt)). [Variables](https://promptmason.ai/docs/variables) and [hidden notes](https://promptmason.ai/docs/text-formatting#hidden-notes) still work in a static prompt: variables are filled in when you copy it, and hidden notes are left out. Use a static prompt when you want the words to stay exactly as they are, or for a one-off prompt that isn't built from blocks. ## Markdown documents A Markdown document is a text file written in Markdown, such as notes or a README. PromptMason keeps it exactly as you write it: no blocks, no variables, and nothing removed. You write one from **Prompts**, then **New**, then **Document**, which shows when the **Markdown documents** feature is on. See [Markdown documents](https://promptmason.ai/docs/markdown-documents). A document counts as one of the 15 prompts on the Free plan. ## Skills A Skill is a set of instructions for an AI app, saved in a folder the app can read. Claude, ChatGPT, Cursor and many other AI apps support Skills. PromptMason checks it and downloads it as a folder. A **Dynamic Skill** is built from blocks on the Build screen, like a dynamic prompt. A **Static Skill** is written in a text box, like a static prompt, but on its own editor screen, where you also fill in its name and description. See [Skills](https://promptmason.ai/docs/skills). A **prompt set** is a list of your prompts in order, made on the Build screen. Copy it to get every step's text, or let an AI agent run the steps one after another. Its kind is **Prompt set**. See [Prompt sets](https://promptmason.ai/docs/prompt-sets). ## Kind and Category Kind and Category are two different things: - **Kind** is what the item is: a **Static Prompt**, **Dynamic Prompt**, **Static Skill**, **Dynamic Skill**, **Prompt set** or **Document**. You choose it when you make the item. On Build, **Build a** switches between **Prompt**, **Skill** and **Prompt set**. - **Category** is a label you choose under **Properties**, such as **User Prompt** or **System Prompt**, or **No category**. It never changes what the item is. You can change it at any time and add your own ([Block types, prompt categories and defaults](https://promptmason.ai/docs/types-and-defaults)). A prompt can become a Skill, and a Skill a prompt: right-click it on the **Prompts** screen and choose **Make it a Skill** or **Make it a prompt**. A static one stays static and a dynamic one stays dynamic. A Skill's fields and files are kept while it is a prompt, so nothing is lost if you switch back. A prompt set and a document stay what they are. ## Write a static prompt 1. Click **Prompts** in the sidebar. 2. Click **New** at the top right, then **Static prompt** (or press Ctrl+N, or Cmd+N on a Mac). If you have no prompts yet, you can click **Write a prompt** instead. 3. Type a name for the prompt. 4. Write the prompt in the large box. The toolbar has bold, italic and lists ([Formatting, block headers and hidden notes](https://promptmason.ai/docs/text-formatting)). To put in a [variable](https://promptmason.ai/docs/variables), type `{{` and pick its name (when the Variables feature is on). 5. Under **Properties**, choose a **Category** and a **Location** (folder). You can also add a **Description**, **Tags** (when the Tags feature is on), and a character limit (**Enforce a character limit**). 6. Click the disk icon (**Save**), or press Ctrl+S (Cmd+S on a Mac). **Save** stays grayed out until the prompt has a name and some text. Once saved, the prompt shows in the list and in the pane on the right, ready to copy. To stop without saving, click the X (**Cancel**) or press Esc. If you've typed anything, PromptMason asks **Discard your new prompt?** Click **Keep Editing** or **Discard Draft**. On the Free plan, if you already have 15 prompts, the **Free plan limit** window opens instead. See [Plans and limits](https://promptmason.ai/docs/plans). ## Edit a prompt How you edit depends on the kind. Start on the Prompts screen and click the prompt to show it on the right. ### A static prompt 1. Click the pencil (**Edit**) at the top of the pane, or double-click the prompt. 2. Change the name, the text, or the **Category**, **Description**, **Tags** or character limit under **Properties**. 3. Click the disk icon (**Save**), or press Ctrl+S. To undo your changes instead, click the X (**Cancel**) or press Esc. This puts the prompt back as it was without asking first. If you click another prompt or screen with unsaved changes, PromptMason asks **Discard your changes?** ### A dynamic prompt 1. Click the pencil (**Open in Build**), or double-click the prompt. It opens on the Build screen. 2. Add, remove or reorder blocks ([Build a prompt](https://promptmason.ai/docs/build-prompt)). 3. Click **Update Prompt** to save and go back to the Prompts screen, or **Apply** to save and stay on Build. ### A Skill A Dynamic Skill opens on the Build screen, like a dynamic prompt. A Static Skill opens on its own editor screen. Click the pencil (**Edit Skill**), or double-click the Skill. See [Skills](https://promptmason.ai/docs/skills). ### A Markdown document 1. Click the pencil (**Edit**), or double-click the document. It opens on its own screen, showing **Preview**. 2. Click **Edit** above the document. 3. Change the text, then click **Update** (or **Apply** to stay on the screen). The pencil only shows while the **Markdown documents** feature is on. With it off, you can still read, copy and download documents. See [Markdown documents](https://promptmason.ai/docs/markdown-documents). ## Change a prompt's kind The app has no button to change a saved prompt's kind. To get a static copy of a dynamic prompt's current text: 1. On the Prompts screen, click the dynamic prompt and click **Copy to Clipboard**. 2. Click **New**, then **Static prompt**, paste the text into the large box, give it a name and save it. The dynamic prompt stays as it was. The new prompt has the text as it was copied: variables are already filled in (if any ask for a value each time, the **Fill in your values** window opens when you copy), and hidden notes are left out. --- How to help me: - Go one step at a time. After each step, ask what I see on screen before giving the next one. - Use the exact words on PromptMason’s buttons and screens, as the guide does. - Never ask me for my recovery code, my recovery kit file, a password or my invite line, and never ask me to paste them here. - Start by asking which step I’m on, or what I see now.Everything on the Prompts screen is one of three kinds: a dynamic prompt, a static prompt or a document. The kind decides where the words come from and how you edit the item. You choose it when you make the item. A dynamic or static prompt can also be a Skill (see Kind and Category).
The three kinds
| Kind | What it is | When a block changes | Edited on |
|---|---|---|---|
| Dynamic | A list of blocks, in order. Its text is put together from the blocks each time you use it. | The prompt changes too. | The Build screen |
| Static | Fixed text. | Nothing happens to it. | The Prompts screen, or for a Skill its own editor screen |
| Document | A Markdown document, kept exactly as written. | Nothing (it has no blocks). | The document editor screen |
In List view, the Kind column says Dynamic Prompt, Static Prompt, Static Skill, Dynamic Skill, Document or Prompt set. Tile view and the pane on the right show the same kind as a badge.


Dynamic prompts
A dynamic prompt is built from library blocks on the Build screen (Build a prompt). It stores which blocks it uses, in what order, and with which block headers, not the text itself.
Because of that, when you change a block, every dynamic prompt that uses it shows the new text the next time you view or copy it. Fix a typo in your “Role” block once, and all your prompts get the fix.
What happens when a block is removed:
- Archived: the block’s text still goes into the prompt, and the block is marked Archived. To leave it out, open the prompt in Build and take the block out.
- Deleted: the prompt shows
[Block removed: name]in its place, with a warning, until you take it out of the prompt or the block is restored from Recently deleted. See Archive, delete and restore.
Use a dynamic prompt when you want your prompts to stay in step with your blocks. That’s most of the time.
Static prompts
A static prompt is fixed text. You get one in two ways:
- Save as Static on the Build screen. The blocks’ text, with its headers, is saved as one piece of text. From then on the prompt has no link to the blocks: changing or deleting a block doesn’t change it.
- Write it yourself on the Prompts screen (see Write a static prompt).
Variables and hidden notes still work in a static prompt: variables are filled in when you copy it, and hidden notes are left out.
Use a static prompt when you want the words to stay exactly as they are, or for a one-off prompt that isn’t built from blocks.
Markdown documents
A Markdown document is a text file written in Markdown, such as notes or a README. PromptMason keeps it exactly as you write it: no blocks, no variables, and nothing removed. You write one from Prompts, then New, then Document, which shows when the Markdown documents feature is on. See Markdown documents.
A document counts as one of the 15 prompts on the Free plan.
Skills
A Skill is a set of instructions for an AI app, saved in a folder the app can read. Claude, ChatGPT, Cursor and many other AI apps support Skills. PromptMason checks it and downloads it as a folder. A Dynamic Skill is built from blocks on the Build screen, like a dynamic prompt. A Static Skill is written in a text box, like a static prompt, but on its own editor screen, where you also fill in its name and description. See Skills.
A prompt set is a list of your prompts in order, made on the Build screen. Copy it to get every step’s text, or let an AI agent run the steps one after another. Its kind is Prompt set. See Prompt sets.
Kind and Category
Kind and Category are two different things:
- Kind is what the item is: a Static Prompt, Dynamic Prompt, Static Skill, Dynamic Skill, Prompt set or Document. You choose it when you make the item. On Build, Build a switches between Prompt, Skill and Prompt set.
- Category is a label you choose under Properties, such as User Prompt or System Prompt, or No category. It never changes what the item is. You can change it at any time and add your own (Block types, prompt categories and defaults).
A prompt can become a Skill, and a Skill a prompt: right-click it on the Prompts screen and choose Make it a Skill or Make it a prompt. A static one stays static and a dynamic one stays dynamic. A Skill’s fields and files are kept while it is a prompt, so nothing is lost if you switch back. A prompt set and a document stay what they are.
Write a static prompt
-
Click Prompts in the sidebar.
-
Click New at the top right, then Static prompt (or press Ctrl+N, or Cmd+N on a Mac). If you have no prompts yet, you can click Write a prompt instead.
-
Type a name for the prompt.
-
Write the prompt in the large box. The toolbar has bold, italic and lists (Formatting, block headers and hidden notes). To put in a variable, type
{{and pick its name (when the Variables feature is on). -
Under Properties, choose a Category and a Location (folder). You can also add a Description, Tags (when the Tags feature is on), and a character limit (Enforce a character limit).


-
Click the disk icon (Save), or press Ctrl+S (Cmd+S on a Mac).
Save stays grayed out until the prompt has a name and some text. Once saved, the prompt shows in the list and in the pane on the right, ready to copy.
To stop without saving, click the X (Cancel) or press Esc. If you’ve typed anything, PromptMason asks Discard your new prompt? Click Keep Editing or Discard Draft.
On the Free plan, if you already have 15 prompts, the Free plan limit window opens instead. See Plans and limits.
Edit a prompt
How you edit depends on the kind. Start on the Prompts screen and click the prompt to show it on the right.
A static prompt
- Click the pencil (Edit) at the top of the pane, or double-click the prompt.
- Change the name, the text, or the Category, Description, Tags or character limit under Properties.
- Click the disk icon (Save), or press Ctrl+S.
To undo your changes instead, click the X (Cancel) or press Esc. This puts the prompt back as it was without asking first. If you click another prompt or screen with unsaved changes, PromptMason asks Discard your changes?
A dynamic prompt
- Click the pencil (Open in Build), or double-click the prompt. It opens on the Build screen.
- Add, remove or reorder blocks (Build a prompt).
- Click Update Prompt to save and go back to the Prompts screen, or Apply to save and stay on Build.
A Skill
A Dynamic Skill opens on the Build screen, like a dynamic prompt. A Static Skill opens on its own editor screen. Click the pencil (Edit Skill), or double-click the Skill. See Skills.
A Markdown document
- Click the pencil (Edit), or double-click the document. It opens on its own screen, showing Preview.
- Click Edit above the document.
- Change the text, then click Update (or Apply to stay on the screen).
The pencil only shows while the Markdown documents feature is on. With it off, you can still read, copy and download documents. See Markdown documents.
Change a prompt’s kind
The app has no button to change a saved prompt’s kind. To get a static copy of a dynamic prompt’s current text:
- On the Prompts screen, click the dynamic prompt and click Copy to Clipboard.
- Click New, then Static prompt, paste the text into the large box, give it a name and save it.
The dynamic prompt stays as it was. The new prompt has the text as it was copied: variables are already filled in (if any ask for a value each time, the Fill in your values window opens when you copy), and hidden notes are left out.