Andrew Yim
6ac547e78f
Some checks failed
Verify Skills / verify-skills (push) Has been cancelled
Adopt: directory keeps its NN- ordering prefix; skill `name:` is the clean form without it (dir 16-seo-schema-validator → name: seo-schema-validator). Nicer to invoke, matches the original desktop/SKILL.md names, still globally unique. - 71 root SKILL.md: name: NN-foo → name: foo (flat skills + reference-curator suite). Plugins (mac-optimizer/multi-agent-guide/dintel-bootstrap) already clean; 95 already clean. - scripts/migrate_skill_root.py: derive name = dirname minus NN- prefix (skill_name()). - CLAUDE.md + SKILL-MIGRATION-GUIDE.md: document the dir-prefix / clean-name convention. verify_skills.py: 0 name collisions across all renamed skills. (The ~/.claude/skills symlinks were re-pointed to the clean names separately — filesystem only.) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.8 KiB
2.8 KiB
name, description
| name | description |
|---|---|
| notion-organizer | Notion workspace manager for database optimization, property cleanup, and bulk operations. Triggers: organize Notion, workspace cleanup, database schema, property standardization. |
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
- Fetch first: Always examine current structure before changes
- Confirm destructive actions: Get user approval for deletes/major restructures
- Estimate impact: For large operations, provide time/API call estimates
- 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