Skill Creator
A skill for creating new skills (instruction sets) for Notion AI, stored as records in the ‣ database, and for iteratively improving them until they perform reliably.
What this skill is for
Use this skill when the user wants to:
- Create a new skill from scratch in the team’s
Skills Database
- Improve an existing skill (clearer scope, better triggering, better outputs)
- Standardise formatting and structure across skills
- Backtest a skill using test prompts and iterate based on results
How Notion AI skills work (in this workspace)
A "skill" is:
- A database page in
Skills Database
- With a Description property — the trigger text the assistant scans to decide whether to load the skill. This is the single most important field for skill performance.
- And a page body containing the instruction set to follow when the skill loads.
- Optionally, nested sub-pages (reference material loaded progressively when the body points to them) and attached files in the Files & media property (fixtures, templates and scripts that Notion AI can upload to its virtual computer and read or execute).
Important context:
- Skills are triggered by the Description match, not the skill name. All trigger conditions belong in the Description; keep instructions in the body.
- Notion AI can write and execute code in a sandbox (a virtual computer) and create and analyse files (CSVs, presentations, and more). Files attached to a skill page's Files & media property can be uploaded into the sandbox and read or executed there. Skills can rely on these capabilities, and this skill uses them for testing.
- The sandbox is ephemeral — nothing in it survives between sessions. Anything that must persist across iterations (test sets, results logs, canonical scripts) lives on the page or as a Files & media attachment; the sandbox is scratch space.
- Keep each skill focused. If it is doing two different jobs, split it.
Skill anatomy