Skip to content
Notomo

Skills

A Skill is a reusable AI instruction saved in Apple Notes. Apple Notes remains the content source; Notomo reads the Skills and stores a synced snapshot for selectors and Actions.

Create the Skills folder

Section titled “Create the Skills folder”
  1. Open Notomo → Settings → AI → Skills.
  2. If there is no Skills folder, click Create Folder.
  3. In the top-level Skills or skills folder in Apple Notes, create one note per Skill.
  4. Return to settings and click Refresh.

You can also use Add Built-in Skills to add examples such as Improve Writing, Proofread, Explain, and Reformat.

Write a Skill

Section titled “Write a Skill”

The note title becomes the Skill name shown in Notomo. The note body contains the instructions sent to the model. State the input, goal, and formatting to preserve clearly.

For example:

# Translate to Chinese


Translate the selected text into Simplified Chinese.
Preserve the original meaning, tone, and formatting.

Add metadata

Section titled “Add metadata”

To provide a description or control Inline AI presentation, add metadata below the title:

# Translate to Chinese


---
name: Translate to Chinese
description: Translate selected text while preserving its meaning and tone.
version: "1.0.0"
presentation: standalone
---


Translate the selected text into Simplified Chinese.
Preserve the original meaning, tone, and formatting.
Field Purpose
name Optional metadata name; Notomo lists still use the Apple Notes title
description Short description shown in Notomo
version Optional version information
presentation edit, standalone, or automatic

Presentation modes differ as follows:

  • edit: Best for proofreading, rewriting, and reformatting; shows a change comparison first.
  • standalone: Best for translations, summaries, explanations, and generated content; shows the result as standalone Markdown.
  • automatic: Let the model decide. Existing Skills without metadata use this mode by default.

Metadata must be enclosed by a pair of --- lines. Field names are case-insensitive, unknown fields are ignored, and unclosed metadata is reported as incomplete.

Use Skills

Section titled “Use Skills”

Synced Skills are available from:

  • The Skill selector in Assistant’s input field.
  • The Inline Toolbar beside a selection in Apple Notes.
  • Actions in other apps, with the default shortcut ⌥⌘P.
  • Notomo’s PopClip extension.

Cross-app Actions confirms again that the original app and selection still match before writing. If Replace or Insert Below cannot be performed safely, Notomo copies the result to the clipboard for you to paste manually.

Management and caching

Section titled “Management and caching”

In Skills settings, disable or pin individual Skills. Disabled Skills do not appear in selectors; pinned Skills appear at the top of lists.

Notomo stores a synced snapshot so Actions can remain available when Apple Notes cannot be read temporarily. Clear Synced Skills Cache deletes only this snapshot, never notes in Apple Notes.