Skip to content
AI & Agents
Skill

/notcrawl

Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.

BOOST
@steipetesteipete@steipete
From plugin
agent-scripts
7.1k54 skills
Install
$ npx -y skills add steipete/agent-scripts --skill notcrawl --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/notcrawl

Context preview

The summary Claude sees to decide when to auto-load this skill.

Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.

SKILL.md

notcrawl.SKILL.md
name: notcrawl
description: "Notion archive: desktop/API sync, Markdown export, page search, read-only SQL."

notcrawl

Use this for local Notion archive questions. Desktop reads local cache; API sync needs `NOTION_TOKEN` and page access.

Sources

  • DB: `~/.notcrawl/notcrawl.db`
  • Pages: `~/.notcrawl/pages`
  • CLI: `notcrawl`

Refresh

notcrawl doctor
notcrawl status
notcrawl sync --source desktop

Use API only when needed and credentials/page access are available:

notcrawl sync --source api

Query Workflow

1. Check freshness for recent/current Notion questions. 2. Search pages first; use read-only SQL for exact counts or schema-level analysis. 3. Use `export-md` when the user needs Markdown files refreshed. 4. Report date spans, page/database IDs, counts, and source limits.

Use root or subcommand help for syntax: `notcrawl --help`, `notcrawl search --help`, `notcrawl sql --help`.

Common commands:

notcrawl search --limit 20 "query"
notcrawl databases
notcrawl sql "select count(*) from pages;"
notcrawl export-md
Read it on GitHub ↗
Ships withagent-scripts

Shared agent instructions, skills, and small portable helpers for Peter's local workspaces.

Get the whole plugin
Stats
TypeScriptJavaScriptHTMLBashSwift
+7 tags
CloudflareGitHubMarkdownAnthropicOpenAIiOSBun
7,208
Stars
617
Forks
Active
Maintenance
Shell
Language
MIT
License
19h ago
Last commit
10mo ago
Created
3h ago
Added

Repo: steipete/agent-scripts

In this plugin
54 skills
See everything inside

Other skills on agent-scripts.

See all 54 skills in agent-scripts