Files
our-claude-skills/ourdigital-custom-skills/02-notion-organizer/SKILL.md
Andrew Yim 341d5f5a5b Initial commit: Claude Skills Factory with 8 refined custom skills
Custom Skills (ourdigital-custom-skills/):
- 00-ourdigital-visual-storytelling: Blog featured image prompt generator
- 01-ourdigital-research-publisher: Research-to-publication workflow
- 02-notion-organizer: Notion workspace management
- 03-research-to-presentation: Notion research to PPT/Figma
- 04-seo-gateway-strategist: SEO gateway page strategy planning
- 05-gateway-page-content-builder: Gateway page content generation
- 20-jamie-brand-editor: Jamie Clinic branded content GENERATION
- 21-jamie-brand-guardian: Jamie Clinic content REVIEW & evaluation

Refinements applied:
- All skills converted to SKILL.md format with YAML frontmatter
- Added version fields to all skills
- Flattened nested folder structures
- Removed packaging artifacts (.zip, .skill files)
- Reorganized file structures (scripts/, references/, etc.)
- Differentiated Jamie skills with clear roles

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-10 17:56:04 +09:00

3.0 KiB

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