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.

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.

The Prompts list with a Kind column showing Dynamic Prompt, Static Prompt, Static Skill, Dynamic Skill and Document.The Prompts list with a Kind column showing Dynamic Prompt, Static Prompt, Static Skill, Dynamic Skill and Document.

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

  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). To put in a variable, 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).

    A new static prompt open for editing with a name, the text box and the Properties section.A new static prompt open for editing with a name, the text box and the Properties section.

  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.

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).
  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.

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.

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.