skilld
All skills
openai avatar

/notion-spec-to-implementation

@136d58a official
by openaiopenai/skills28k stars
1,891

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/openai/skills/notion-spec-to-implementation

This session only. Nothing lands on disk.

referencetask-creation-template.md

≈150 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Task Creation Template

When creating tasks from spec.

# [Task Name]

## Context
Part of implementation for <mention-page url="...">Feature Spec</mention-page>

Implementation plan: <mention-page url="...">Implementation Plan</mention-page>

## Description
[What needs to be done]

## Acceptance Criteria
- [ ] [Criterion 1]
- [ ] [Criterion 2]

## Technical Details
[Technical approach or notes]

## Dependencies
- Blocked by: [Task] or None
- Blocks: [Task] or None

## Resources
- [Link to design]
- [Link to related code]

## Progress
[To be updated during implementation]

Source: SKILL.md on GitHub

Third-party checks

2 warnings17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    This skill provides templates and workflows to translate Notion specifications into actionable implementation plans and tasks. It includes a few security considerations regarding the ingestion of external data from user-controlled documents, which are standard for automation and parsing workflows.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: MEDIUM · 1 issue

  • Runlayer7mo

    6/17 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 136d58a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 10 months ago

Capability

Other metadata
metadata
{
  "short-description": "Turn Notion specs into implementation plans, tasks, and progress tracking"
}

Topics

  • notion
  • project-management
  • task-tracking
  • prd
  • implementation-planning
  • workflow
  • notion-mcp

README badge

README badge for openai/skills/notion-spec-to-implementation

What it does

Converts a Notion spec document into a linked implementation plan with tasks and status tracking, using Notion MCP calls to search, fetch, create pages, and update progress. Targets teams using Notion for PRDs and feature specs who want to automate plan generation and task creation from written requirements.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with Notion MCP?
Yes. It requires the Notion MCP to be installed and authenticated via OAuth. If the MCP is not connected, the skill includes setup steps to add it and log in.
Can I use this skill for any kind of spec, or only certain types?
The skill works for any spec stored in Notion. It includes both quick and full implementation plan templates, so you can adapt the depth to simple changes or multi-phase features.
What Notion operations does this skill perform?
It searches and fetches specs, creates plan and task pages, updates pages with links and progress, and manages relations between spec, plan, and task artifacts.
Does this skill automatically generate task acceptance criteria?
No. The skill provides templates and patterns (in reference/task-creation-template.md) to guide task content, but you compose the acceptance criteria based on the spec requirements.

Generated from the current SKILL.md. These answers refresh after source changes.