Agent skill

Notion Pm

by borghei in borghei/Claude-Skills

Notion expert for product management workflows. An agent skill from borghei/Claude-Skills.

MITAuto-check passedProduct & Project Management

Install Notion Pm

skills CLI
$ npx skills add borghei/Claude-Skills --skill notion-pm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills notion-pm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/notion-pm .claude/skills/notion-pm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notion-pm
GitHub stars
886
Token cost
~1.7k tokens
SKILL.md length
725 words
Files
9 (incl. references, assets)
Skills in repo
354
Repo updated
First seen
Licence
MIT

At a glance

Notion expert for product management workflows. An agent skill from borghei/Claude-Skills.

  • Database design for PRDs/OKRs/Roadmaps/Decisions
  • SKILL.md covers Overview, Core Capabilities, When to Use and References, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Property and view design

What it does

Notion Pm is an agent skill from borghei/Claude-Skills. Notion expert for product management workflows. Use for database design for PRDs/OKRs/Roadmaps/Decisions, property and view design, page architecture, Notion REST API, and sync with Jira, Linear, and GitHub.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files and assets (for example `assets/notion-okr-template.md`, `assets/notion-prd-template.md` and `assets/notion-roadmap-template.md`).

It sits in Product & Project Management, covering OKRs and executive reporting, PRD writing and Database schema design. It works with Notion, GitHub and Jira. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Database design for PRDs/OKRs/Roadmaps/Decisions
  • Property and view design
  • Page architecture
  • Notion REST API

Example prompts

  • “/notion-pm”

What it can do on your machine

Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • developers.notion.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion Pm loads about 1.7k tokens when it runs, and up to ~15k if it reads all its reference files. Until then it costs about 54 tokens; SKILL.md has 725 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~15k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 725 words, ~1,682 tokens.

Download SKILL.mdSave it as .claude/skills/notion-pm/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
notion-pm
description
Notion expert for product management workflows. Use for database design for PRDs/OKRs/Roadmaps/Decisions, property and view design, page architecture, Notion REST API, and sync with Jira, Linear, and GitHub.
license
MIT + Commons Clause
metadata.version
1.0.1
metadata.author
borghei
metadata.category
project-management
metadata.domain
pm-integration
metadata.updated
2026-06-15
metadata.tech-stack
notion, rest-api, jira, linear, github
metadata.tags
notion, databases, prd, okr, roadmap, decisions

Notion for Product Management

Master-level expertise in using Notion as the documentation and operational backbone for a product team: PRDs, OKRs, roadmaps, decision logs, sprint reviews, 1:1 notes, customer research, and sync patterns with Jira, Linear, and GitHub. Covers Notion's database model, view design, formula and rollup patterns, page architecture, and REST API.

Overview

Notion's PM value comes from its database model: every meaningful PM artifact (a PRD, an OKR, a roadmap row, a decision) becomes a row in a typed database, with relations to other databases. This unlocks linked views (one source of truth, many surface presentations), rollups (aggregate child progress into a parent), and a queryable API. The job of a Notion PM expert is to design these databases up front, restrain ad-hoc page creation, and tie the workspace into Jira/Linear/GitHub so the artifacts stay current without manual maintenance.

Core Capabilities

  • Database design — typed schemas for PRDs, OKRs, Roadmap, Decisions, and Sprint/Cycle Reviews, with the right property types (relation, rollup, formula, status, unique_id).
  • View design — Table, Board, Timeline, Calendar, Gallery, and List views with filters, sorts, and groups tuned per artifact.
  • Page & workspace architecture — Teamspace setup, curated home dashboards, linking strategy (relations vs mentions vs sub-pages), governance and review cadence.
  • REST API authoring — query/create/update/append calls, compound filters, pagination, and rate-limit handling.
  • Sync patterns — one-way, two-way, roll-up, and embed integrations with Jira, Linear, and GitHub.

When to Use

  • Standing up a new product team's documentation workspace
  • Designing a PRD, OKR, Roadmap, or Decisions database from scratch
  • Refactoring an existing Notion workspace that has grown into a sprawl of unrelated pages
  • Building roadmap or status views aggregated from underlying issue trackers
  • Authoring Notion REST API calls (page creation, database queries, block updates)
  • Setting up two-way sync between Notion and Jira/Linear/GitHub
  • Establishing governance: ownership, review cadence, archive strategy

References

Pull the reference that matches the task; keep this file lean and load detail on demand.

  • references/notion-pm-playbook.md — the full operational playbook: core concepts (hierarchy, property types, views, block types), the seven core workflows (workspace setup, PRD/OKR/Roadmap/Decisions/Review DB design, linking, sync), inline API/query examples, best practices, troubleshooting, and success criteria. Read when building or refactoring a workspace.
  • references/notion-api-patterns.md — full REST API call catalog with request/response examples, targeting Notion-Version: 2025-09-03 (databases → data sources; as of September 2026). Read when authoring API integrations.
  • references/notion-database-design-for-pm.md — canonical schemas for PRDs, OKRs, Roadmap, Decisions, Reviews. Read when designing the database relations.
  • references/red-flags.md — concrete examples of how Notion PM setups go wrong and how to fix them. Read when reviewing a workspace for quality.
  • assets/notion-prd-template.md — PRD page template using Notion-native blocks.
  • assets/notion-roadmap-template.md — Roadmap database schema and view definitions.
  • assets/notion-okr-template.md — OKR database schema with Wodtke confidence model.
  • Notion API docs: https://developers.notion.com/ — reference: https://developers.notion.com/reference/intro — changelog: https://developers.notion.com/page/changelog
Show full SKILL.md (280 more words)Show less

Scope & Limitations

In Scope: Notion workspace and Teamspace setup, database design for PRDs/OKRs/Roadmap/Decisions/Reviews/1:1s, view design, property and relation modeling, page architecture, Notion REST API authoring, sync pattern design with Jira/Linear/GitHub, governance and review cadences.

Out of Scope: Notion administration (SCIM, SAML, billing) at the workspace level beyond Teamspace setup. Jira space and project configuration (hand off to jira-expert/ and confluence-expert/). Linear configuration (hand off to linear-expert/). Strategic OKR setting (hand off to execution/brainstorm-okrs/). Story splitting and backlog refinement (hand off to execution/backlog-refinement/, execution/story-splitting/).

Limitations: Notion's API rate limits (~3 req/s) make it unsuitable for very high-throughput sync; batch and queue. Status properties cannot have options created via the API in lower plan tiers; pre-create options manually. Rollups cannot reference rollups in older API versions; chain via formulas where needed. Page-level permissions can be overridden in unexpected ways by Teamspace-level changes. Notion is not a real-time collaboration substitute for chat; do not try to replace Slack with comments.

Integration Points

IntegrationDirectionWhat Flows
jira-expert/Notion ↔ JiraPRD-to-Epic creation; Jira issue embeds in PRD pages
confluence-expert/MigrationWhen moving from Confluence to Notion, structure and content mapping
linear-expert/Notion ↔ LinearPRD-to-Project creation; Linear progress rollups into Notion
execution/create-prd/PRD → NotionPRD scaffolder output rendered as Notion blocks via --format notion
execution/brainstorm-okrs/OKR → NotionOKR validator output written to the OKR DB
execution/outcome-roadmap/Roadmap → NotionRoadmap rows materialized in the Roadmap DB
execution/daci-framework/Decision → NotionDACI decisions logged in the Decisions DB
execution/status-update-generator/Notion → StatusWeekly status pulls aggregates from PRDs/OKRs DBs
execution/release-notes/Notion → ReleaseShipped PRDs feed release notes input
senior-pm/Notion → PortfolioOKR and Roadmap DBs feed portfolio reports
discovery/interview-synthesis/Research → NotionCustomer research database populated from interview synth output

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references, assets) in project-management/notion-pm of borghei/Claude-Skills.

  • SKILL.md
  • assets/notion-okr-template.md
  • assets/notion-prd-template.md
  • assets/notion-roadmap-template.md
  • examples/product-team-workspace-buildout.md
  • references/notion-api-patterns.md
  • references/notion-database-design-for-pm.md
  • references/notion-pm-playbook.md
  • references/red-flags.md

Open the folder on GitHubat commit 4a698e8

Compare with similar skills

Notion Pm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion Pm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion Pm this skillborghei/Claude-Skills886—~1.7kAutomated safety check: PassMIT
Integration Orchestratorrampstackco/claude-skills941—~5.3kAutomated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Find Project Anomaliespenpot/penpot61k—~1.2kAutomated safety check: PassMPL-2.0
Product Roadmaptikalk/adlc-team-skills141—~3.1kAutomated safety check: PassMIT
Autoudecode/kitcn451—~4.7kAutomated safety check: PassApache-2.0

Similar skills

  • Integration Orchestrator

    rampstackco/claude-skills

    Generate a phased delivery orchestration plan for creative-direction-driven work: which skills run when, what locks at which gate, how handoffs occur, and how the cadence implements in the team's…

    941 GitHub stars~5.3k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Check a GitHub milestone against the Main project board, report the five anomaly types to tmp/<MILESTONE-ANOMALIES.md, and fix missing milestone assignments on request.

    61k GitHub stars~1.2k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Product Roadmap

    tikalk/adlc-team-skills

    A skill your agent uses when doing weekly progress checks or milestone validation — tracks decision, execution, evidence, and gate states across four layers of truth.

    141 GitHub stars~3.1k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Auto

    udecode/kitcn

    Autonomous kitcn supervisor for sweep, clean, full, design, milestone, PRD, timed, and review-until work.

    451 GitHub stars~4.7k tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed
  • Plan Create Stories

    coleam00/skills

    Decomposes a PRD into well-formed, engineer-ready tickets — Jira issues or GitHub issues.

    674 GitHub stars~922 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from borghei/Claude-Skills

All 354 skills in this repo
  • Agent Harness

    borghei/Claude-Skills

    Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.

    886 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    886 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    886 GitHub stars~3.6k tokensUpdated 2 days ago
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    886 GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    886 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed

Questions about Notion Pm

What does Notion Pm do?

Notion expert for product management workflows. An agent skill from borghei/Claude-Skills. Notion Pm is an agent skill from borghei/Claude-Skills. Notion expert for product management workflows.

When should I use Notion Pm?

Notion Pm fits situations like: database design for PRDs/OKRs/Roadmaps/Decisions; property and view design; page architecture; notion REST API.

How do I install Notion Pm in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill notion-pm -a claude-code`. Or copy the skill folder (project-management/notion-pm in borghei/Claude-Skills) into .claude/skills/notion-pm in your project. Claude Code loads it when a task matches its description.

How do I install Notion Pm in Codex?

Run `npx skills add borghei/Claude-Skills --skill notion-pm -a codex`. Or copy the skill folder (project-management/notion-pm in borghei/Claude-Skills) into .agents/skills/notion-pm in your project. Codex loads it when a task matches its description.

Can I use Notion Pm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill notion-pm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion-pm, .gemini/skills/notion-pm, .github/skills/notion-pm and .opencode/skills/notion-pm in your project.

What does Notion Pm need to run?

SKILL.md names no scripts, command-line tools or credentials: Notion Pm is instructions for the agent only.

Does Notion Pm access the network?

SKILL.md names 1 domain. As links in the text: developers.notion.com. This is read from the text; nothing was executed.

Is Notion Pm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion Pm use?

Notion Pm is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion Pm use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Notion Pm?

Skills that share tags, products or a category with Notion Pm: Integration Orchestrator (rampstackco/claude-skills, 941 stars), CCPM Project Management (automazeio/ccpm, 8.4k stars), Find Project Anomalies (penpot/penpot, 61k stars) and Product Roadmap (tikalk/adlc-team-skills, 141 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion Pm?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 886 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.