notion-spec-to-implementation · makenotion — Claude Code skill
Turns technical specifications in Notion into structured implementation plans and tracker tasks. Useful when breaking product requirements down into development milestones.
npx skills add makenotion/claude-code-notion-plugin --skill notion-spec-to-implementation -a claude-code
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a claude-codeWhat notion-spec-to-implementation does
This skill guides the agent from an initial feature writeup directly to task tracking. The assistant locates the specification via Notion:notion-search, retrieves its content with Notion:notion-fetch, and extracts functional requirements alongside acceptance criteria. It then drafts a dedicated plan page covering technical steps and risk factors.
After outlining the plan, the agent inspects your task database schema and populates individual task entries with priority tags and backlinks. During implementation, progress logs and status updates run through Notion:notion-update-page. If search queries fail to match the target database or document, you must supply its direct Notion ID to keep the flow moving.
What it helps with
- extract requirements and acceptance criteria from Notion specifications
- create structured implementation plan pages for new features
- populate project task databases with linked engineering items
- update execution status and log daily progress in Notion
Example prompts for the agent
- Find the User Authentication spec in Notion and build an implementation plan
- Break down requirements from the mobile redesign spec into our task database
- Update the active Notion task status and record today's progress notes
How to install notion-spec-to-implementation
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill notion-spec-to-implementation -a claude-codenpx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a claude-code2Manually: put the files in place
~/.claude/skills/spec-to-implementation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/spec-to-implementation/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a codex2Manually: put the files in place
.agents/skills/spec-to-implementation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a cursor2Manually: put the files in place
.cursor/skills/spec-to-implementation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/claude-code-notion-plugin spec-to-implementation2Manually: put the files in place
.github/skills/spec-to-implementation/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/claude-code-notion-plugin --path skills/notion/spec-to-implementationManually: put the files in place
.devin/skills/spec-to-implementation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about notion-spec-to-implementation
How do I install notion-spec-to-implementation in Claude Code?
Run npx skills add makenotion/claude-code-notion-plugin --skill notion-spec-to-implementation -a claude-code. This registers the skill for your Claude Code setup.
What does notion-spec-to-implementation do?
It reads specification pages in Notion, pulls out requirements, and generates both an implementation plan and linked task entries in your database.
What if the agent cannot find the spec or task database through search?
When search queries yield ambiguous or empty results, provide the page or database ID directly so the agent can fetch the schema and content.
Similar skills
All skills for Notes, tasks and projects →notion-spec-to-implementation by other authors comes first.