# notion-spec-to-implementation

Turns technical specifications in Notion into structured implementation plans and tracker tasks. Useful when breaking product requirements down into development milestones.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 358 installs · ★ 499
- Author: makenotion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makenotion/claude-code-notion-plugin/tree/HEAD/skills/notion/spec-to-implementation/SKILL.md
- Updated: 2026-01-22
- HTML: https://affpapa.org/en/nevibecode/skills/notion-spec-to-implementation-2

## What it 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.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill notion-spec-to-implementation -a claude-code
```
```bash
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/spec-to-implementation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/spec-to-implementation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/spec-to-implementation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/spec-to-implementation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makenotion/claude-code-notion-plugin spec-to-implementation
```

2. **Manually: put the files in place**
- File: `.github/skills/spec-to-implementation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makenotion/claude-code-notion-plugin --path skills/notion/spec-to-implementation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/spec-to-implementation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add makenotion/claude-code-notion-plugin --skill spec-to-implementation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makenotion/claude-code-notion-plugin/tree/HEAD/skills/notion/spec-to-implementation/SKILL.md

## When to use it
- 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
- 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

## Similar
- [notion-knowledge-capture](https://affpapa.org/en/nevibecode/skills/notion-knowledge-capture.md) — skill · 16 installs
- [notion-meeting-intelligence](https://affpapa.org/en/nevibecode/skills/notion-meeting-intelligence.md) — skill · 15 installs
- [notion-mcp](https://affpapa.org/en/nevibecode/skills/notion-mcp.md) — skill · 735 installs
- [notion-api](https://affpapa.org/en/nevibecode/skills/notion-api.md) — skill · 94900 installs
- [notion](https://affpapa.org/en/nevibecode/skills/notion.md) — skill · 5600 installs
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 4800 installs

## Other versions with the same name
- [notion-spec-to-implementation · openai](https://affpapa.org/en/nevibecode/skills/notion-spec-to-implementation.md) — 14 installs

From the same set: [makenotion/claude-code-notion-plugin](https://affpapa.org/en/nevibecode/by/makenotion/claude-code-notion-plugin.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md