# Note Toolbar API

> Note Toolbar API is an Agent Skill for development published in the chrisgurney/obsidian-note-toolbar repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Write, edit, or debug JavaScript that uses the Note Toolbar `ntb` API inside Obsidian. Use this skill whenever the user wants to script a toolbar item, use ntb.prompt / ntb.suggester / ntb.fileSuggester / ntb.menu / ntb.modal, read or write note properties via ntb.getProperty / ntb.setProperty, work with toolbar items via ntb.getItem / ntb.getToolbars, or combine the ntb API with Dataview JS, JS Engine, or Templater. Also trigger for any script that references `ntb`, `NtbSuggester`, or 'Note Toolbar API'.

- Skill name: `note-toolbar-api`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/chrisgurney/obsidian-note-toolbar/blob/HEAD/skills/note-toolbar-api/SKILL.md
- Repository: chrisgurney/obsidian-note-toolbar (750 GitHub stars when collected)

## SKILL.md

# Note Toolbar API

Full reference: https://raw.githubusercontent.com/wiki/chrisgurney/obsidian-note-toolbar/Note-Toolbar-API.md

Fetch the full reference before writing or editing any script.

## Code conventions

- Comments start with a lower-case character.
- Use `activeWindow.navigator` (not bare `navigator`) for clipboard/permission-sensitive APIs.
- Use `normalizePath()` for vault paths.
- Keep scripts minimal; avoid unnecessary variables.
- Null-check all UI method results — every `ntb` UI call returns `null` if dismissed: `if (!result) return;`
- Inline scripts are plain JS; no type annotations.

---

Source: https://www.openparable.com/skill/development/note-toolbar-api (OpenParable). Cite the canonical URL above.
