notion-spec-to-implementation

Installation
Summary

Convert Notion specs into linked implementation plans, tasks, and progress tracking.

  • Automates the workflow from spec discovery through task creation: search and fetch specs, parse requirements, generate implementation plans, and create tracked tasks in Notion.
  • Includes templates for quick vs. full implementation plans, task creation patterns, and progress update cadences to match project scope.
  • Provides reference guides for requirement extraction, task sizing (1–2 day chunks), dependency mapping, and milestone tracking.
  • Requires Notion MCP setup via OAuth; handles linking between spec, plan, and task artifacts with automatic status synchronization.
SKILL.md

Spec to Implementation

Convert a Notion spec into linked implementation plans, tasks, and ongoing status updates.

Quick start

  1. Locate the spec with Notion:notion-search, then fetch it with Notion:notion-fetch.
  2. Parse requirements and ambiguities using reference/spec-parsing.md.
  3. Create a plan page with Notion:notion-create-pages (pick a template: quick vs. full).
  4. Find the task database, confirm schema, then create tasks with Notion:notion-create-pages.
  5. Link spec ↔ plan ↔ tasks; keep status current with Notion:notion-update-page.

Workflow

0) If any MCP call fails because Notion MCP is not connected, pause and set it up:

  1. Add the Notion MCP:
    • codex mcp add notion --url https://mcp.notion.com/mcp
  2. Enable remote MCP client:
    • Set [features].rmcp_client = true in config.toml or run codex --enable rmcp_client
  3. Log in with OAuth:
Related skills

More from openai/skills

Installs
1.0K
Repository
openai/skills
GitHub Stars
18.9K
First Seen
Jan 20, 2026