Skill

notion-spec-to-implementation

by openai

AI Summary

Converts Notion product specs and PRDs into structured implementation plans, tasks, and progress tracking within Notion. Ideal for product managers and engineers who need to translate specifications into actionable work items.

Install

# Add to your project root as SKILL.md
curl -o SKILL.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/SKILL.md"

Description

Turn Notion specs into implementation plans, tasks, and progress tracking; use when implementing PRDs/feature specs and creating Notion plans + tasks from them.

References and examples

• reference/ — parsing patterns, plan/task templates, progress cadence (e.g., spec-parsing.md, standard-implementation-plan.md, task-creation.md, progress-tracking.md). • examples/ — end-to-end walkthroughs (e.g., ui-component.md, api-feature.md, database-migration.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.

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

• Add the Notion MCP: • codex mcp add notion --url https://mcp.notion.com/mcp • Enable remote MCP client: • Set [features].rmcp_client = true in config.toml or run codex --enable rmcp_client • Log in with OAuth: • codex mcp login notion After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.

Quality Score

C

Acceptable

71/100

Standard Compliance45
Documentation Quality60
Usefulness75
Maintenance Signal100
Community Signal100
Scored Today

GitHub Signals

Stars10.2k
Forks569
Issues104
UpdatedToday
View on GitHub

Trust & Transparency

No License Detected

Review source code before installing

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit Today

10.2k stars — Strong Community

569 forks

My Fox Den

Community Rating

Works With

Claude Code