Skip to content
Skills Library
Personal productivity · Automation

notability-notes

/notability-notes

Use when you need to find a note (list, search, recent, by folder), open its details, create, rename, move, duplicate, tag or delete notes, or restore something from the trash. Run `notability notes --help` for every flag.

Licence
MIT
Last repository change
26.10.2026

Assessment and security

85/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when you need to find a note (list, search, recent, by folder), open its details, create, rename, move, duplicate, tag or delete notes, or restore something from the trash. Run `notability notes --help` for every flag.

Original author description

Use when you need to find a note (list, search, recent, by folder), open its details, create, rename, move, duplicate, tag or delete notes, or restore something from the trash. Run `notability notes --help` for every flag.

How it works

  1. Commands
  2. notes trash
  3. Conventions
Original SKILL.md headings · 38 lines, 419 words
SKILL.md preview
---
name: notability-notes
description: "Use when you need to find a note (list, search, recent, by folder), open its details, create, rename, move, duplicate, tag or delete notes, or restore something from the trash. Run `notability notes --help` for every flag."
requires_bin: notability
command: notability notes
---

# notability notes

Find, open and manage notes in your library (incl. trash).

Use when you need to find a note (list, search, recent, by folder), open its details, create, rename, move, duplicate, tag or delete notes, or restore something from the trash.

## Commands

- `notability notes list`: List notes (filter by folder, type, favourites; sort; paginate). Flags: `--folder`, `--sort`, `--asc`, `--favorites`, `--type`, `--limit`.
- `notability notes search <query>`: Search titles, optionally typed/handwritten text. Flags: `--content`, `--content-limit`, `--limit`.
- `notability notes get <note>`: One note: metadata, pages, recordings, Learn status; --format md for markdown. Flags: `--learn`, `--as`.
- `notability notes index`: Build/refresh the local full-text index (cache only). Flags: `--limit`, `--refresh`, `--clear`.
- `notability notes create <title>`: Create an empty, seeded note. Flags: `--folder`. Safety: writes (MCP needs --allow-writes).
- `notability notes rename <note> <new-title>`: Rename a note. Safety: writes (MCP needs --allow-writes).
- `notability notes duplicate <note>`: Copy a note. Flags: `--title`. Safety: writes (MCP needs --allow-writes).
- `notability notes move <note> [folder]`: Move a note to a folder (or unfiled). Safety: writes (MCP needs --allow-writes).
- `notability notes favorite <note>`: Star or unstar a note (--off). Flags: `--off`. Safety: writes (MCP needs --allow-writes).
- `notability notes layout <note> <mode>`: Switch paged / pageless. Safety: writes (MCP needs --allow-writes).
- `notability notes delete <note>`: Move to trash, or --permanent. Flags: `--permanent`. Safety: destructive: needs --yes (MCP: confirm=true, otherwise a dry-run preview; needs --allow-writes).

## notes trash

Deleted notes: list, restore, purge, empty.

- `notability notes trash list`: List trashed notes. Flags: `--match`, `--limit`.
- `notability notes trash restore <note>`: Restore a trashed note. Safety: writes (MCP needs --allow-writes).
- `notability notes trash purge <note>`: Permanently delete one trashed note. Safety: destructive: needs --yes (MCP: confirm=true, otherwise a dry-run preview; needs --allow-writes).
- `notability notes trash empty`: Purge trash (--match/--all, --dry-run). Flags: `--match`, `--all`, `--dry-run`. Safety: destructive: needs --yes (MCP: confirm=true, otherwise a dry-run preview; needs --allow-writes).

## Conventions

- Reference a note by id, an id prefix (6+ characters), its exact title, or `folder/path/title`.
- Output is TOON by default; pass `--json` (full envelope) or `--format json|yaml|md`. Large results take `--token-limit`; list commands page with `--limit` and `--cursor` (from `meta.next_cursor`).
- Exit codes: 0 ok, 1 runtime error, 2 usage error or missing confirmation.
- Destructive commands need `--yes`; without it a non-interactive run stops with CONFIRM_REQUIRED and changes nothing.
- Over MCP (`notability --mcp`) tools are named after the path joined with `_` (e.g. `content_text_add`). Write tools appear only with `--allow-writes`, AI tools only with `--allow-ai`.

Versions

The database has no other skills named notability-notes.

Database snapshot: 13.11.2026 · package version e256e6aa295f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85notability-chat
    Use when asking Notability AI questions about notes or reading and managing chat threads. Run `notability chat --help` for every flag.
  • 90notability
    Notability from the terminal or MCP: notes, folders, note content, files, audio, sharing, Learn study tools, AI chat and account. Use when the user mentions Notability or their notes there; this routes to the per-area notability-* skills.
  • 100vault-fs
    Safely move, rename, or trash notes and attachments in an Obsidian vault while keeping every link working. Use whenever a vault file operation is requested — "move this note to X", "rename note", "reorganize folder", "bulk move", "archive these notes", "delete/trash this note",…
  • 100apple-notes
    Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks CoWork-OSS to add a note, list notes, search notes, or manage note folders.
  • 86apple-notes
    Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, list notes, search notes, or manage note folders.
  • 100handwritten-notes-pdf
    Use when the user wants a handwritten-style (手写风 / 手写版) review PDF of lecture or course notes on grid paper, to read or annotate in Notability on iPad — including the default follow-up after a lecture-tutor 讲解 note, or requests like "手写版", "手写笔记", "网格纸笔记", "Notability 复习版".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.