notes-export

notes-export is a skill for Claude Code from terrylica/cc-skills. It costs 94 tokens per session (1,157 once invoked), scanned A, original, MIT.

A backup tool for Apple Notes that exports every note from all accounts and folders as Markdown files, plus a JSON index describing the notes and folders. Apple Notes is Apple's built-in note-taking app.

In plain words
What is it for?
Backing up notes, retaining folder structure and metadata, and creating a machine-readable manifest for audits or later processing.
Why use it?
It preserves a local snapshot before notes are reorganized and provides files that other tools can inspect or compare.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the notes-commander plugin — 5 skills shipped together , and of cc-skills

Good fit Backing up notes, retaining folder structure and metadata, and creating a machine-readable manifest for audits or later processing.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/terrylica/cc-skills/notes-export
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add terrylica/cc-skills --skill notes-export
Clone the repo
git clone --depth 1 https://github.com/terrylica/cc-skills

Made for: Claude Code.

Or install notes-commander, the plugin that ships this one along with the rest of its 5 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for notes-export

README.md
[![agentmods](https://agentmods.dev/badge/skills/terrylica/cc-skills/notes-export/github.svg)](https://agentmods.dev/skills/terrylica/cc-skills/notes-export)
Your own site
<a href="https://agentmods.dev/skills/terrylica/cc-skills/notes-export"><img src="https://agentmods.dev/badge/skills/terrylica/cc-skills/notes-export/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for notes-export

Your own site · 80×15
<a href="https://agentmods.dev/skills/terrylica/cc-skills/notes-export"><img src="https://agentmods.dev/badge/skills/terrylica/cc-skills/notes-export.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 94 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,157 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Rogue Agent · line 46
    Skill modifies its own code, configuration, or behavior at runtime. Self-modification enables an agent to escalate privileges, disable safety constraints, or install persistent backdoors.
    Fix: Prevent the skill from modifying its own code, SKILL.md, or configuration files. Treat skill files as read-only at runtime.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00094 $0.01157
Opus 5.5 $0.00038 $0.00463
Sonnet 5.5 $0.00019 $0.00231
Haiku 4.5 $0.00009 $0.00116

Measured 18d ago against content hash d2537e81f467, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

notes-export scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 18d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/notes-commander/skills/notes-export/SKILL.md · 40 lines

How it starts

The opening of the file, as written. The whole thing — 40 lines — stays where its author put it; the contents beside it link to each section on GitHub.

notes-export — full local snapshot of Apple Notes

Self-Evolving skill — if export behavior drifts (AE size caps, chunk failures, encoding), fix this SKILL.md and scripts/notes.ts OSA_EXPORT (+ a test in notes-core.test.ts for any pure helper change); see the Post-Execution Reflection at the bottom.

One command captures everything Notes holds into a timestamped local snapshot:

NC="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/notes-commander/scripts/notes.ts"
bun "$NC" export                     # → ~/.local/share/notes-commander/export/<stamp>/
bun "$NC" export --out /path/to/dir  # explicit destination

What a snapshot contains:

  • One markdown file per note, under <account>/<folder>/… mirroring the Notes hierarchy. Each file has YAML frontmatter (account, folder, id, modified) and the note body as plain text (decoded via textutil, UTF-8-safe, CJK-safe).
  • manifest.json — every folder (with counts) and every note (id, name, modified, relative file path, char count). This is the machine-readable index for audits and diffs. It also carries complete (false when anything was skipped) and skipped.folders / skipped.notes with the reason for each, so the manifest alone tells a full backup from a partial one — check complete before trusting a snapshot, not just that manifest.json exists.
  • Filenames are sanitized (safeFilename) and suffixed with the note's core-data id (.p1234.md), so same-titled notes never collide.

Rules

  • Run this before any notes-organize operation — it is the undo story. Notes has no API-level undo; a snapshot does.
  • The default root (~/.local/share/notes-commander/export/) is deliberately OUTSIDE any git repo so note content can never be accidentally committed. Don't redirect --out into a repo.
  • Snapshots are full (not incremental); each run creates a new timestamped dir. Old snapshots are plain dirs — delete them manually when no longer wanted.
  • Recently Deleted is deliberately skipped (restore a note in the Notes UI first if you want it captured).
  • A large library takes a few minutes (verified live: 400 notes ≈ 2.5 min) — bodies are fetched in chunks of 20 because one giant Apple Event reply blows the AE size cap (-1741). A failed chunk degrades to per-note fetches; a still-failing note becomes a warning + exit code 3 (partial export is LOUD, never silent). The same holds for a note whose text conversion fails (⚠ note skipped (text conversion failed)): it is skipped, the rest of the snapshot and manifest.json are still written. Transient -600/-1712 launch races retry automatically.

Read the full file on GitHub · 40 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 18d ago Changed · -11 lines d2537e81f467
  2. 26d ago Changed · +4 lines 92b977bc2289
  3. 1mo ago First seen · 47 lines · 94 tokens per session scan A d832f3b73302

Subscribe to this mod's changes

notes-export is a skill published in the GitHub repository terrylica/cc-skills (0 stars, last pushed yesterday), licensed MIT. It adds 94 tokens to every session and 1,157 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-05.

Related

Other skills, from other repositories

investment-memo-generator

Investment memo creation combining financial analysis, document generation, and structured templates. Use when creating investment memos, pitch decks, deal summaries, or investment committee materials.

travisjneuman/.claude · 37 tokens

impact-report-writer

Nonprofit/NGO impact report generation with data visualization suggestions, outcome metrics, narrative structure, and program data presentation. Use when writing impact reports, annual reports, or program evaluation summaries.

travisjneuman/.claude · 43 tokens

codebase-documenter

Write codebase documentation: READMEs, architecture docs, getting-started guides, API docs, and code comments. Use when documenting code or making a project easier for new developers.

travisjneuman/.claude · 42 tokens

agent-documentation-writer

Specialist subagent: Generates comprehensive documentation including READMEs, API docs, architecture docs, and inline comments. Use when documenting code, creating guides, or explaining systems.

travisjneuman/.claude · 41 tokens

video-timeline

Turn a final TTS audio track (with its timed transcript) into an editable story timeline (xlsx) for a human to fill with images, slides, and video clips. Audits the audio against timing best practices first, then maps each finding to a visual offset, and QA-scores the timeline objectively. Use when a finished…

Elumenotion/GuideAnts · 81 tokens

transcript-to-pdf

Convert a GuideAnts / Code-Executor markdown conversation transcript into a styled, print-ready PDF with a cover page, role-badged turns, full tool-call inputs (heredoc-aware) and highlighted code. Use when the user wants to export, archive, or share a conversation log as a polished PDF document.

Elumenotion/GuideAnts · 71 tokens