Out of the box, Mira ships with a set of default skills — short markdown documents that teach Mira how to handle specific tasks in Revit (placing families, creating dynamic tools, working with detail standards, and more). Custom skills let you add your own — your firm's naming conventions, drawing standards, modeling habits, or any other guidance you'd otherwise have to repeat to Mira every time.
You don't need to write anything yourself. Just tell Mira what you want it to remember, and it will draft the skill for you. You review, tweak if needed, and save. No file editing, no markdown syntax to learn.
What a skill actually is
A skill is a short instruction file Mira reads at the start of every chat turn. It can describe:
Conventions — "Our firm names views as [Discipline]_[Level]_[Name]. Always rename new views to match."
Workflows — "Before placing a new wall, check the level is set to the active design level shown in the title block."
Tool usage — "When the user asks for a schedule, use
CreateSchedulewith the field order Type, Mark, Family, Comments."Constraints — "Never delete a view referenced by a sheet without asking first."
Recipes — multi-step procedures Mira should follow for a recurring task.
Once saved, a skill applies on the very next message — no restart, no recompile.
Create a skill by asking Mira
This is the easiest way, and the one most people use.
Step 1: Tell Mira what you want it to remember
In the Mira chat panel, just describe the rule, workflow, or convention in plain English. Some prompts that work well:
"Write me a custom skill that tells you to follow our firm's view naming standard: [Discipline]_[Level]_[Name]."
"Create a skill for our sheet setup routine. Every new sheet should have the title block set to our firm template, the scale set to 1/8" = 1'-0", and the revision schedule populated from the project info."
"Save a skill so you remember that whenever I create a wall, you check the level matches the active design level shown in the title block."
The trigger word is "skill" — when Mira hears it, it knows you want it to draft markdown rather than just answer the question.
Step 2: Review what Mira drafts
Mira writes the proposed skill content in your custom skills folder. To find it, Navigate to Settings -> Skills -> Open Folder:
Open Custom folder:
Read it carefully — does it actually capture what you meant? Common things to check:
Is the trigger right? The skill's opening line should describe when it applies. "Apply when the user asks to create a new sheet" tells Mira when to activate.
Are the rules specific? "Be careful with deletions" is too vague. "Before deleting any view, run
FindReferencingSheetsand confirm with the user if the count > 0" is enforceable.Is anything missing? If you wanted three rules and Mira drafted two, ask for the third.
If you want changes, just tell Mira: "Make it stricter about always asking before renaming" or "Add an example for SITE level". It will revise the draft.
The skill is active immediately. The very next message you send to Mira will include it.
A few common reasons to adjust a skill:
Mira isn't applying it consistently. Usually means the trigger is too vague. Make the "when to apply" line more specific.
Mira applies it when it shouldn't. The trigger is too broad. Narrow it ("Only when the user is working on a sheet view, not a model view").
Your firm's standard changed. Update the rule and Mira picks up the new version immediately.
To delete a skill, click the trash icon next to it in the list. Default skills can't be deleted — they're re-deployed every time Revit launches.
What makes a good skill
When you review Mira's draft (or write one from scratch), check it against these:
Lead with a clear title and trigger
Every skill starts with a heading and a one-line "apply when…" statement. That's how Mira knows the skill is relevant.
# Sheet Setup Routine
Apply when the user asks to create a new sheet or set up the title block on an existing one.
Keep it short
Every word in a skill is added to every chat turn's prompt — so a 200-line skill costs tokens on every message, even when the topic is unrelated. Aim for 10–60 lines per skill. If it's growing past that, split it into two skills with narrower triggers.
Be specific, not aspirational
❌ Vague | ✅ Specific |
Be careful with deletions | Before deleting any view, run |
Follow our naming standard | View names follow |
Use the right schedule fields | When asked for a schedule, use |
Use numbered lists for workflows
When you want Mira to follow a sequence, write it as a numbered list. Mira parses the structure and tends to follow steps in order.
Show examples — especially the bad ones
A two-column "Bad / Good" table is the highest-signal pattern in any skill. If Mira's draft doesn't include one and the skill has a "do it like this, not like that" flavor, ask Mira to add the examples.
A complete example — Sheet Setup Routine
Here's the full lifecycle of one custom skill, end to end.
The prompt:
"Write me a custom skill called Sheet Setup Routine. Every time I create a new sheet, you should set the title block to our firm template, make the scale 1/8" = 1'-0" unless I tell you otherwise, populate the revision schedule from project info, and ask me whether to add the sheet to the active sheet list."
What Mira drafts:
# Sheet Setup Routine
Apply when the user asks to create a new sheet, or duplicates an existing one.
## Steps
1. Set the title block to the firm's standard template. If unsure which template, use the one assigned to the active project; surface the choice if more than one matches.
2. Default scale: 1/8" = 1'-0". Don't change unless the user specifies otherwise.
3. Populate the revision schedule from the project's Project Information parameters.
4. After setup, ask the user: "Should I add this sheet to the active sheet list?" Only add if they confirm.
## Don't
- Don't apply a title block from another firm's project — always use the active firm's template.
- Don't auto-populate the sheet number; the user picks the sheet number when they create the sheet.
What you might tweak:
Maybe your firm uses
1/4" = 1'-0"more often than1/8"— change the default.Maybe step 4 should be "always add to the sheet list" instead of asking — remove the question.
Maybe you want an additional rule: "If the sheet is part of a structural set, use the S- prefix sheet template instead."
Make those edits in the Settings editor, save, and the next sheet you create will follow the updated routine.
Tips for getting the most out of skills
One concern per skill. If a skill covers naming, geometry, AND scheduling, split it into three. Smaller skills are easier for Mira to apply at the right moments.
Let Mira help you refine. When you correct Mira the same way twice in a conversation, ask: "Can you update the [skill name] skill so you remember this?" It will draft an updated version.
Test by replaying a real task. After saving a skill, ask Mira to do the thing you wrote the skill for. If it gets it wrong, the skill needs sharper language.
Mind the token budget. Every skill is in the prompt for every message. If you have 20 skills totaling 5,000 lines, each turn pays for that overhead. Prune skills you're no longer using.
Share skills across your firm. Skills live on the machine that created them, but the folder is just files — see "Advanced" below.
Advanced: edit and sync skills as files
If you'd rather work in a text editor, or want to share skills across your team:
In Mira Settings → Skills, click Open skills folder. File Explorer opens at
%APPDATA%\PirrosChatbot\skills\.The
custom/subfolder contains your skills — one folder per skill, each with a singleSKILL.mdfile.Edit the markdown directly. Save. Mira picks up the change on the next message.
Don't edit anything in default/. Those files are overwritten every time Revit launches. To override a default skill, create a custom skill with a different name that says "instead of [default skill], do X."
Sync across team machines:
Drop
%APPDATA%\PirrosChatbot\skills\custom\into a OneDrive or Dropbox folder, then point it at the same location on each team member's machine.Or treat the folder as a git repo and
git pullon each machine.
When you onboard a new team member, they inherit every skill your firm has authored.
Frequently Asked Questions
Q: Do custom skills sync across machines automatically?
A: No. Skills live on the machine that created them. Use OneDrive, Dropbox, or git to sync the %APPDATA%\PirrosChatbot\skills\custom\ folder (see the Advanced section above).
Q: Can a custom skill have the same name as a default skill?
A: No — the Settings UI rejects names that would shadow a default skill. Pick a different name. If you want to extend a default behavior, name your skill something like "Sheet Setup — firm extensions" and reference the default by name in the content.
Q: Do skills cost extra credits?
A: There's no per-skill charge, but every skill is included in every message's prompt, which marginally increases per-turn token cost. In practice this is small for skills under ~60 lines, but it adds up if you accumulate many large skills.
Q: Where can I see what Mira is actually reading from my skills?
A: The Settings panel shows the full content of each loaded skill. Both default and custom skills appear in the same list, with a label showing which folder they came from.
Q: Does Mira always follow a skill?
A: Mira treats skill content as guidance, not absolute rules. If your skill says "always rename new views" but the user explicitly says "don't rename this one," Mira will follow the user. Phrase your skills as conventions Mira can apply unless overridden.
Q: What if my skill contradicts a default skill?
A: Mira sees both. More specific instructions generally win, and instructions later in the prompt have a small recency advantage. If you want to override a default behavior, write the override explicitly — e.g. "Default skill X says to do Y, but in this firm we do Z instead, because [reason]."
Q: I'm getting an error when I save a skill.
A: The most common causes are: skill name is blank, content is blank, name conflicts with a default skill, or a custom skill with the same name already exists. The error message in the Settings UI will tell you which. If you're hitting something else, email [email protected].