Przejdź do treści
Biblioteka skilli
Produktywność osobista · Automatyzacja

automating-notes

/automating-notes

Automatyzuje Apple Notes przez JXA: konta, foldery, notatki, treści HTML, zapytania, przenoszenie oraz zapasowe mosty Objective-C i UI.

Licencja
MIT
Ostatnia zmiana repozytorium
22.08.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
11
Skrypty
5
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 22.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/create_note.py, scripts/create_notes_folder.py, scripts/search_notes.py, scripts/set_up_notes_automation.py, scripts/set_up_notes_automation.sh

Co robi i kiedy

Automatyzuje Apple Notes przez JXA: konta, foldery, notatki, treści HTML, zapytania, przenoszenie oraz zapasowe mosty Objective-C i UI.

Wyzwalacze z opisu

create notes programmaticallyautomate Notes appJXA notes scriptingorganize notes with automation
Oryginalny opis (EN)

Automates Apple Notes via JXA. Use when asked to "create notes programmatically", "automate Notes app", "JXA notes scripting", or "organize notes with automation". Covers accounts/folders/notes, HTML bodies, queries, moves, and Objective-C/UI fallbacks for Notes.app automation on macOS.

Jak działa

  1. Relationship to the macOS automation skill
  2. Core framing
  3. Workflow (default)
  4. Quickstart (ensure path + create)
  5. Validation Checklist
  6. HTML & fallbacks
  7. When Not to Use
  8. What to load
Sekcje z nagłówków SKILL.md, w oryginale · 183 linii, 725 słów
Podgląd SKILL.md
---
name: automating-notes
description: Automates Apple Notes via JXA. Use when asked to "create notes programmatically", "automate Notes app", "JXA notes scripting", or "organize notes with automation". Covers accounts/folders/notes, HTML bodies, queries, moves, and Objective-C/UI fallbacks for Notes.app automation on macOS.
allowed-tools:
  - Bash
  - Read
  - Write
---

# Automating Apple Notes (JXA-first, AppleScript discovery)

## Relationship to the macOS automation skill
- Standalone for Notes; reuse `automating-mac-apps` for permissions, shell, and Objective-C/UI scripting patterns.
- **PyXA Installation:** To use PyXA examples in this skill, see the installation instructions in `automating-mac-apps` skill (PyXA Installation section).

## Core framing
- Notes uses an AEOM hierarchy: Application → Accounts → Folders → Notes (with nested folders).
- **Load:** `automating-notes/references/notes-basics.md` for complete specifier reference.

## Workflow (default)
1) Resolve account/folder explicitly (iCloud vs On My Mac); validate existence and permissions.
2) Ensure target path exists (create folders if needed); handle creation failures gracefully.
3) Create notes with explicit `name` and HTML `body`; verify creation success.
4) Query/update with `.whose` filters; batch delete/move as needed; check counts before/after operations.
5) For checklists/attachments, use clipboard/Objective-C scripting if dictionary support is insufficient; test fallbacks.
6) For meeting/people workflows, file notes under `meetings/<company>/<date>-<meeting-title>` and `people/<first>-<last>/...`; validate final structure.

## Quickstart (ensure path + create)

**JXA (Legacy):**
```javascript
const Notes = Application("Notes");

// Ensure folder path exists, creating intermediate folders as needed
function ensurePath(acc, path) {
  const parts = path.split("/").filter(Boolean);
  let container = acc;
  parts.forEach(seg => {
    let f; try {
      f = container.folders.byName(seg);
      f.name(); // Verify access
    } catch (e) {
      // Folder doesn't exist, create it
      f = Notes.Folder({ name: seg });
      container.folders.push(f);
    }
    container = f;
  });
  return container;
}

try {
  // Get iCloud account and ensure meeting folder exists
  const acc = Notes.accounts.byName("iCloud");
  const folder = ensurePath(acc, "meetings/Acme/2024-07-01-Review");

  // Create new note in the folder
  folder.notes.push(Notes.Note({
    name: "Client Review",
    body: "<h1>Client Review</h1><div>Agenda...</div>"
  }));
  console.log("Note created successfully");
} catch (e) {
  console.error("Failed to create note: " + e.message);
}
```

**PyXA (Recommended Modern Approach):**
```python
import PyXA

notes = PyXA.Notes()

def ensure_path(account, path):
    """Ensure folder path exists, creating intermediate folders as needed"""
    parts = [p for p in path.split("/") if p]  # Filter empty parts
    container = account

    for part in parts:
        try:
            # Try to find existing folder
            folder = container.folders().by_name(part)
            folder.name()  # Verify access
        except:
            # Folder doesn't exist, create it
            folder = notes.make("folder", {"name": part})
            container.folders().push(folder)

        container = folder

    return container

try:
    # Get iCloud account
    account = notes.accounts().by_name("iCloud")

    # Ensure meeting folder exists
    folder = ensure_path(account, "meetings/Acme/2024-07-01-Review")

    # Create new note in the folder
    note = folder.notes().push({
        "name": "Client Review",
        "body": "<h1>Client Review</h1><div>Agenda...</div>"
    })

    print("Note created successfully")

except Exception as e:
    print(f"Failed to create note: {e}")
```

**PyObjC with Scripting Bridge:**
```python
from ScriptingBridge import SBApplication

notes = SBApplication.applicationWithBundleIdentifier_("com.apple.Notes")

def ensure_path(account, path):
    """Ensure folder path exists, creating intermediate folders as needed"""
    parts = [p for p in path.split("/") if p]
    container = account

    for part in parts:
        try:
            folder = container.folders().objectWithName_(part)
            folder.name()  # Verify access
        except:
            # Create new folder
            folder = notes.classForScriptingClass_("folder").alloc().init()
            folder.setName_(part)
            container.folders().addObject_(folder)

        container = folder

    return container

try:
    # Get iCloud account
    accounts = notes.accounts()
    account = None
    for acc in accounts:
        if acc.name() == "iCloud":
            account = acc
            break

    if account:
        # Ensure meeting folder exists
        folder = ensure_path(account, "meetings/Acme/2024-07-01-Review")

        # Create new note
        note = notes.classForScriptingClass_("note").alloc().init()
        note.setName_("Client Review")
        note.setBody_("<h1>Client Review</h1><div>Agenda...</div>")

        folder.notes().addObject_(note)

        print("Note created successfully")
    else:
        print("iCloud account not found")

except Exception as e:
    print(f"Failed to create note: {e}")
```

## Validation Checklist
- [ ] Account access works (iCloud vs On My Mac)
- [ ] Folder creation and path resolution succeeds
- [ ] Note creation with valid HTML body completes
- [ ] Note appears in Notes UI
- [ ] `.whose` queries return expected results
- [ ] Error handling covers missing accounts/folders

## HTML & fallbacks
- Allowed tags: `<h1>-<h3>`, `<b>`, `<i>`, `<u>`, `<ul>/<ol>/<li>`, `<div>/<p>/<br>`, `<a>`.
- **Security:** Always sanitize HTML input; avoid `<script>`, `<style>`, or event handlers to prevent XSS in rendered notes.
- Checklists/attachments: Objective-C/clipboard fallback (Cmd+Shift+L for checklist, paste image via NSPasteboard + System Events).
- Append helper: replace `</body>` with extra HTML, or append when missing; validate HTML structure post-modification.

## When Not to Use
- Cross-platform note taking (use Notion API, Obsidian, or Markdown files)
- iCloud sync operations requiring status feedback (limited API support)
- Non-macOS platforms
- Rich formatting beyond supported HTML tags
- Collaborative editing workflows (no multi-user support)

## What to load
- Basics & specifiers: `automating-notes/references/notes-basics.md`
- Recipes (create/move/query/ensure path/checklists): `automating-notes/references/notes-recipes.md`
- Advanced (HTML body rules, attachments/UI, JSON import/export, ObjC bridge): `automating-notes/references/notes-advanced.md`
- Dictionary/type map: `automating-notes/references/notes-dictionary.md`
- **PyXA API Reference** (complete class/method docs): `automating-notes/references/notes-pyxa-api-reference.md`
Pliki w paczce (11)
  • SKILL.md 7 KB
  • references/notes-advanced.md 1 KB
  • references/notes-basics.md 1 KB
  • references/notes-dictionary.md 1 KB
  • references/notes-pyxa-api-reference.md 18 KB
  • references/notes-recipes.md 4 KB
  • scripts/create_note.py 2 KB
  • scripts/create_notes_folder.py 2 KB
  • scripts/search_notes.py 2 KB
  • scripts/set_up_notes_automation.py 1 KB
  • scripts/set_up_notes_automation.sh 1 KB

Wersje

W bazie nie ma innych skilli o nazwie automating-notes.

Migawka bazy z 13.11.2026 · wersja paczki 6c8dd4fb5c73 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100automating-contacts
    Automatyzuje Kontakty macOS przez JXA ze słownikiem AppleScript: zapytania, CRUD, pola wielowartościowe, grupy, obrazy i zapasowe mosty ObjC.
  • 100automating-reminders
    Automatyzuje Przypomnienia Apple przez JXA: listy i przypomnienia, filtrowanie zapytaniami whose, wydajne tworzenie przez konstruktory i push oraz przenoszenie przez kopiowanie i usuwanie.
  • 100apple-notes-install-auth
    Konfiguruje dostęp automatyzacji macOS do Apple Notes przez AppleScript, JXA i Skróty: uprawnienia dostępności i dostęp osascript.
  • 100apple-notes-core-workflow-a
    Buduje zautomatyzowane przepływy zarządzania notatkami w Apple Notes skryptami JXA: masowe tworzenie, synchronizacja ze źródeł zewnętrznych, foldery i szablony.
  • 100apple-notes
    Obsługuje Apple Notes na macOS: tworzy, przeszukuje, aktualizuje i porządkuje notatki oraz foldery przez narzędzia MCP.
  • 100apple-notes
    Zarządza Apple Notes na macOS: listuje, wyszukuje, czyta, tworzy, dopisuje, przenosi, usuwa i eksportuje notatki oraz zarządza folderami, lokalnie w Notes.app.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.