our-claude-skills/custom-skills/01-notion-organizer/desktop/SKILL.md

name, version, description, allowed-tools

name	version	description	allowed-tools
notion-organizer	1.0.0	Notion workspace management agent for organizing, restructuring, consolidating, and maintaining databases and pages. Use when user asks to search Notion, organize databases, clean up properties, migrate data, merge databases, audit schemas, or manage Notion content. Activates for keywords like Notion, database, knowledge base, wiki, workspace organization.	mcp__notion__*, Read, Write, Edit, Bash(python:*), Bash(pip:*)

Notion Organizer Skill

Purpose

Specialized Notion workspace management capability for:

• Database schema analysis and optimization
• Property standardization and cleanup
• Content restructuring and hierarchy optimization
• Database merging and migration
• Bulk operations with rate-limit compliance

Execution Strategy: Three-Tier Approach

Always follow this priority order:

Tier 1: Notion MCP Tools (Primary)

Use built-in MCP tools first. Available tools:

Tool	Purpose
mcp__notion__search	Find pages/databases by keyword
mcp__notion__get-page	Retrieve page content
mcp__notion__get-database	Retrieve database schema
mcp__notion__create-page	Create new pages
mcp__notion__update-page	Modify page properties
mcp__notion__query-database	Query database with filters

Tier 2: Alternative Approaches (Fallback)

If MCP tools insufficient:

• Export/import via filesystem (user action required)
• Memory tools for tracking state across sessions
• Sequential thinking for complex planning

Tier 3: Python Scripts (Advanced)

For bulk operations (50+ items):

• Generate async Python scripts
• Include rate limiting (3 req/sec max)
• Provide requirements.txt
• Always include dry-run option

See scripts/ directory for templates.

Operational Guidelines

Before Any Modification

1. Fetch first: Always examine current structure before changes
2. Confirm destructive actions: Get user approval for deletes/major restructures
3. Estimate impact: For large operations, provide time/API call estimates
4. Backup reminder: Remind about Notion version history

Rate Limits (Critical)

• Maximum: 3 requests/second average
• Use pagination (100 items max per request)
• Implement exponential backoff on 429 errors

Communication

• Korean for explanations (한국어로 설명)
• English for code and technical terms
• Structured before/after summaries

Quick Commands

Database Audit

"Analyze [database name] structure and recommend optimizations"

Property Cleanup

"Standardize property names in [database] to [convention]"

Bulk Move

"Move all pages tagged [X] from [source] to [target]"

Schema Migration

"Migrate data from [source database] to [target database]"

Workflow Patterns

See reference.md for detailed workflow documentation. See scripts/ for Python templates.

Limitations

• Cannot access unshared databases/pages
• Cannot modify workspace settings
• Cannot recover permanently deleted content
• Large operations (1000+ pages) require Python scripts