Claude Skills by jeremylongshore

'Integrate the Notion API into CI/CD pipelines for automated documentation

'Diagnose and fix Notion API errors by HTTP status code and error code.

'Create, update, archive, and compose Notion pages and block content.

'Query, filter, and manage Notion databases and pages.

Work with Notion blocks, rich text, comments, and page content. Use when you need to read a page's block tree, append formatted content (headings, lists, callouts, code), edit or delete blocks, build rich text with annotations, or manage page and block comments through the Notion API. Trigger with phrases like "notion blocks", "notion page content", "notion rich text", "notion comments", "notion append blocks".

'Optimize Notion API usage to minimize rate-limit pressure, reduce engineering

Implement data handling, PII protection, and GDPR/CCPA compliance for Notion integrations. Use when handling sensitive data from Notion pages, implementing data redaction, exporting or deleting a user's data on request, or ensuring compliance with privacy regulations. Trigger with phrases like "notion data", "notion PII", "notion GDPR", "notion data retention", "notion privacy", "notion CCPA".

'Collect Notion API diagnostic info for troubleshooting and support tickets.

Deploy Node.js applications that use the Notion API to production on Vercel, Railway, or Fly.io. Use when deploying Notion-powered backends, setting up NOTION_TOKEN in production secrets, configuring serverless singleton patterns, or adding health checks that verify Notion connectivity. Trigger with "deploy notion app", "notion production", "notion vercel deploy", "notion railway", "notion fly.io".

'Configure Notion enterprise access control with OAuth, workspace permissions,

'Create a minimal working Notion API example.

Execute Notion incident response procedures with triage, mitigation, and postmortem. Use when responding to Notion API outages, investigating errors, or running post-incident reviews for Notion integration failures. Trigger with phrases like "notion incident", "notion outage", "notion down", "notion on-call", "notion emergency", "notion broken".

'Install and configure the Notion API SDK with authentication.

Use when debugging or reviewing Notion API code that fails with object_not_found, validation_error, rate_limited, or returns incomplete data. Covers the twelve most common mistakes: wrong page ID format (dashes), rich text array structure, block children not returned with page, pagination required for all lists, 3 req/sec shared across endpoints, and not sharing pages with the integration. Trigger with phrases like "notion mistakes", "notion pitfalls", "notion common errors", "notion gotchas"...

Use when you must move high volumes through the Notion API without tripping its 3 req/sec limit — bulk-creating pages, syncing 100K+ record databases, or running background jobs. Covers parallel requests within 3 req/sec, worker queues, database pagination at scale, incremental sync for large workspaces, and memory management for bulk operations. Trigger with phrases like "notion scale", "notion bulk operations", "notion high volume", "notion worker queue", "notion incremental sync".

Configure Notion local development with a dedicated dev integration, test mocking, and hot reload. Use when setting up a Notion development environment, writing tests for Notion code, or establishing a fast iteration cycle against the Notion API without risking production data. Trigger with "notion dev setup", "notion local development", "mock notion", "notion test environment".

'Migrate data to/from Notion or between Notion workspaces with data mapping

Configure Notion integrations across development, staging, and production environments. Use when setting up multi-environment deployments, managing per-environment tokens, or implementing environment-specific Notion configurations. Trigger with phrases like "notion environments", "notion staging", "notion dev prod", "notion environment setup", "notion config by env".

'Set up observability for Notion integrations with metrics, traces, and

'Optimize Notion API performance with caching, batching, parallel requests,

Use when you need to govern Notion integrations at scale — set integration naming standards, enforce page sharing policies, standardize property naming and database schemas, and run access audits that scan which bots can reach which pages. Trigger with phrases like "notion governance", "notion policy", "notion naming convention", "notion access audit", "notion schema standard".

Execute a Notion API production deployment checklist and readiness verification. Use when deploying Notion integrations to production, preparing for launch, verifying go-live readiness, or auditing an existing Notion integration. Trigger with "notion production checklist", "deploy notion integration", "notion go-live", "notion launch readiness", "notion prod audit".

'Manage Notion API rate limits with exponential backoff, queue-based

Design and implement a production-ready Notion integration architecture with proper layering, caching, error handling, and testing strategies. Use when designing a new Notion integration, reviewing existing project structure, establishing architecture standards for a Notion application, or migrating from ad-hoc API calls to a layered architecture. Trigger with "notion architecture", "notion project structure", "notion reference architecture", "notion integration design", "notion layered archi...

'Graceful degradation when Notion is down: offline cache, retry with

Apply production-ready @notionhq/client SDK patterns for TypeScript and Python. Use when implementing Notion integrations, building database queries with filters and sorts, handling pagination, constructing rich text blocks, or establishing team coding standards for Notion API usage. Trigger with "notion SDK patterns", "notion best practices", "notion code patterns", "idiomatic notion", "notion typescript", "notion python SDK".

'Search Notion workspaces and retrieve pages, databases, and block content

Apply Notion API security best practices for integration tokens, OAuth2 flows, least-privilege capabilities, and page-level access control. Use when securing integration tokens, configuring OAuth2 for public integrations, rotating credentials, or auditing which pages an integration can access. Trigger with phrases like "notion security", "notion secrets", "secure notion", "notion API key security", "notion token rotation", "notion OAuth2", "notion permissions audit".

'Upgrade @notionhq/client SDK versions and migrate between Notion API

'Build change detection and event handling for Notion workspaces using

'Set up GitHub Actions CI/CD for Obsidian plugin development.

'Diagnose and fix common Obsidian plugin errors and exceptions.

'Create an Obsidian plugin from scratch with full project scaffolding.

'Build advanced Obsidian plugin features: custom views (ItemView), modals,

'Optimize Obsidian resource usage, sync storage, Publish hosting, and

'Implement vault data backup, sync, and recovery strategies.

'Collect Obsidian plugin debug evidence for support and troubleshooting.

'Publish Obsidian plugins to the community plugin directory.

'Implement team vault access patterns and role-based controls.

'Create a minimal working Obsidian plugin with commands, settings, modals,

'Troubleshoot Obsidian plugin failures with systematic incident response.

'Set up Obsidian plugin development environment with Node.js and TypeScript.

'Set up a fast Obsidian plugin development loop with hot reload.

'Execute major Obsidian plugin rewrites and migration strategies.

'Configure multiple Obsidian environments for development, testing, and

'Implement structured logging, metrics, error tracking, and a debug panel

'Optimize Obsidian plugin performance for smooth operation in large vaults.

'Pre-release plugin verification checklist for Obsidian community plugins.

'Handle Obsidian file system operations and throttling patterns.

'Implement Obsidian reference architecture with best-practice project