Agent skill · Notion

Notion Spec to Implementation skill for Claude Code, Codex and Cursor

Turns a spec stored in Notion into an implementation plan with linked tasks and status updates.

Officialname: notion-spec-to-implementation★ 220 (repo)pushed 2026-10-24MITSKILL.md on GitHubchecked 2026-11-07

What it does, in the publisher's words

Converts Notion product or technical specs into implementation plans, linked tasks, and evidence-based progress updates. Use for planning or implementing a spec, creating tasks from requirements, or reconciling implementation with spec changes.

The description field of the SKILL.md. The agent reads only this at startup and decides from it when to load the full skill.

Install Notion Spec to Implementation

The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation

Copy the skill folder into ~/.claude/skills (all projects) or .claude/skills (this repo). Claude Code picks it up without a restart. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation -a claude-code

# or by hand:
git clone --depth 1 https://github.com/makenotion/notion-cookbook.git /tmp/spec-to-implementation-src
cp -r /tmp/spec-to-implementation-src/skills/mcp-clients/spec-to-implementation ~/.claude/skills/notion-spec-to-implementation

Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs

git clone --depth 1 https://github.com/makenotion/notion-cookbook.git /tmp/spec-to-implementation-src
cp -r /tmp/spec-to-implementation-src/skills/mcp-clients/spec-to-implementation ./notion-spec-to-implementation
zip -r notion-spec-to-implementation.zip notion-spec-to-implementation

Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation -a codex

gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs

gh skill install makenotion/notion-cookbook notion-spec-to-implementation

Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation -a cursor

Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs

gemini skills install https://github.com/makenotion/notion-cookbook.git --path skills/mcp-clients/spec-to-implementation

OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation -a opencode

Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs

npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation -a windsurf

Works with

Claude Code, Claude.ai and Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and other agents that read the open Agent Skills format.

What's in the SKILL.md

5 sections

Workflow
Traceability and changes
Notion execution
Optional references
Show the saved result

Bundled files

agents/openai.yaml
evaluations/README.md
evaluations/basic-spec-implementation.json
evaluations/discover-spec-and-destination.json
evaluations/implement-small-spec.json
evaluations/partial-create-recovery.json
evaluations/spec-change-progress.json
evaluations/spec-to-tasks.json
examples/api-feature.md
examples/database-migration.md
examples/ui-component.md
reference/milestone-summary-template.md
reference/progress-tracking.md
reference/progress-update-template.md
reference/quick-implementation-plan.md
reference/spec-parsing.md
reference/standard-implementation-plan.md
reference/task-creation-template.md
reference/task-creation.md

Loaded only when the instructions point to them.

Facts

Skill name: notion-spec-to-implementation
Publisher: Notion (official)
Repo: makenotion/notion-cookbook
License: MIT
SKILL.md size: 734 words, 92 lines
Bundled files: 19, 12 docs
Repo stars: 220 (as of 2026-10-24)
SKILL.md checked: 2026-11-07

Pairs with the Notion MCP server: the server gives the agent the tools, the skill teaches it how to use them.

More skills from makenotion/notion-cookbook

Notion Knowledge Capture: Saves conversations and notes into Notion as wiki pages, how-tos, FAQs or decision records.
Notion Research Docs: Searches across a Notion workspace and writes a cited brief or comparison.

Related workflow & planning skills

Skill Creator · Anthropic
GitHub: Address PR Comments · OpenAI
Skill Installer (Codex) · OpenAI
Modern Python Tooling · Trail of Bits
Commit (Sentry style) · Sentry
Brainstorming · Jesse Vincent (obra)
Requesting Code Review · Jesse Vincent (obra)
Subagent-Driven Development · Jesse Vincent (obra)

FAQ

What does the notion-spec-to-implementation skill do?+

Turns a spec stored in Notion into an implementation plan with linked tasks and status updates. In its own SKILL.md, Notion describes it as: "Converts Notion product or technical specs into implementation plans, linked tasks, and evidence-based progress updates. Use for planning or implementing a spec, creating tasks from requirements, or reconciling implementation with spec changes."

How do I install the notion-spec-to-implementation skill?+

Run npx skills add makenotion/notion-cookbook --skill notion-spec-to-implementation and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/notion-spec-to-implementation/SKILL.md; in Codex and Cursor in .agents/skills/notion-spec-to-implementation/.

Does Notion Spec to Implementation work in Codex, Cursor and Copilot, or only Claude?+

It's a standard SKILL.md, so any agent that reads the Agent Skills format can use it: Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.

Who maintains Notion Spec to Implementation?+

Notion, the company or project behind it, in the makenotion/notion-cookbook repo on GitHub, last pushed 2026-10-24. License: MIT.

Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. Claude skills marketplace · How to install skills · MCP servers