How do I install notion-spec-to-implementation?

notion-spec-to-implementation is a Skill hosted on GitHub at https://github.com/openai/skills. Visit the ImAiFox page at https://imaifox.com/boosters/openai-skills-notion-spec-to-implementation for the AI-ready install prompt you can copy directly into Claude Code, Cursor, or Windsurf.

How popular is notion-spec-to-implementation?

notion-spec-to-implementation has 16,812 GitHub stars and 1,037 forks. It is actively maintained with recent commits.

Is notion-spec-to-implementation free?

Yes — notion-spec-to-implementation is open source and free to use. The source code is publicly available on GitHub at https://github.com/openai/skills.

Skill

notion-spec-to-implementation

Name: notion-spec-to-implementation
Author: openai

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

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "notion-spec-to-implementation" skill in my project.

Please run this command in my terminal:
# Install skill into your project (19 files)
mkdir -p .claude/skills/notion-spec-to-implementation && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/SKILL.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/LICENSE.txt "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/LICENSE.txt" && mkdir -p .claude/skills/notion-spec-to-implementation/agents && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/agents/openai.yaml "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/agents/openai.yaml" && mkdir -p .claude/skills/notion-spec-to-implementation/assets && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/assets/notion-small.svg "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/assets/notion-small.svg" && mkdir -p .claude/skills/notion-spec-to-implementation/assets && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/assets/notion.png "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/assets/notion.png" && mkdir -p .claude/skills/notion-spec-to-implementation/evaluations && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/evaluations/README.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/evaluations/README.md" && mkdir -p .claude/skills/notion-spec-to-implementation/evaluations && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/evaluations/basic-spec-implementation.json "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/evaluations/basic-spec-implementation.json" && mkdir -p .claude/skills/notion-spec-to-implementation/evaluations && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/evaluations/spec-to-tasks.json "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/evaluations/spec-to-tasks.json" && mkdir -p .claude/skills/notion-spec-to-implementation/examples && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/examples/api-feature.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/examples/api-feature.md" && mkdir -p .claude/skills/notion-spec-to-implementation/examples && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/examples/database-migration.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/examples/database-migration.md" && mkdir -p .claude/skills/notion-spec-to-implementation/examples && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/examples/ui-component.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/examples/ui-component.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/milestone-summary-template.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/milestone-summary-template.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/progress-tracking.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/progress-tracking.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/progress-update-template.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/progress-update-template.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/quick-implementation-plan.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/quick-implementation-plan.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/spec-parsing.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/spec-parsing.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/standard-implementation-plan.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/standard-implementation-plan.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/task-creation-template.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/task-creation-template.md" && mkdir -p .claude/skills/notion-spec-to-implementation/reference && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/notion-spec-to-implementation/reference/task-creation.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/notion-spec-to-implementation/reference/task-creation.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

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.

Discussion

0/2000

Loading comments...

Health Signals

MaintenanceCommitted 4d ago

● Active

Adoption1K+ stars on GitHub

16.8k ★ · Popular

DocsREADME + description

Well-documented

GitHub Signals

Stars16.8k

Forks1.0k

Issues188

Updated4d ago

View on GitHub

No License

My Fox Den

Community Rating

Works With

Claude Code

Related Skills

gh-issues

Skill

xlsx

Skill

SEO Specialist

Agent

Analytics Reporter

Agent

View all Skills →