skills.rest
fairy-pitta
fairy-pittaCOMMUNITY
Explore all skills by this author →
GitHub

link-notion

Create bidirectional links between Notion tasks and GitHub Pull Requests.

Updated Jan 26, 2026
Search Tags:#task management#github#notion#traceability#pr#linking
One-click install
npx skills add https://github.com/fairy-pitta/claude-dotfiles --skill link-notion
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: link-notion
Source: https://github.com/fairy-pitta/claude-dotfiles/tree/main/skills/link-notion
Command: npx skills add https://github.com/fairy-pitta/claude-dotfiles --skill link-notion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines project management by automatically creating bidirectional links between your Notion tasks and GitHub Pull Requests, ensuring seamless traceability and reducing manual cross-referencing.

Core Features & Use Cases

  • Automated Linking: Connects Notion tasks to GitHub PRs based on branch names, PR titles, or commit messages.
  • Bidirectional Traceability: Establishes links in both directions, allowing easy navigation between platforms.
  • Use Case: When you create a PR for a feature branch named feat/TASK-123-implement-login, this Skill will find the corresponding task in Notion, add a link to the PR in the Notion task's comments, and append a link to the Notion task in the PR's description.

Quick Start

Use the link-notion skill to connect the current GitHub PR to its corresponding Notion task.

Frequently Asked Questions about link-notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I link Notion tasks to GitHub PRs automatically?▼

To link Notion tasks to GitHub PRs, this Skill uses branch names, PR titles, or commit messages to find the corresponding task and creates bidirectional links. It appends a link to the PR in Notion comments and adds the Notion task link to the PR description.

What is needed to connect Notion tasks to GitHub Pull Requests?▼

Connecting Notion tasks to GitHub Pull Requests requires the GitHub CLI and Notion MCP integration. These dependencies are necessary for retrieving PR information and creating comments in Notion to establish bidirectional traceability.

How does bidirectional traceability work between Notion and GitHub?▼

Bidirectional traceability between Notion and GitHub works by creating links in both platforms. The Skill adds a GitHub PR link to the Notion task's comments and simultaneously appends the Notion task link to the PR's description for easy navigation.

Can I use branch names to automate linking Notion tasks and GitHub PRs?▼

Yes, you can use branch names to automate linking Notion tasks and GitHub PRs. When you create a PR for a branch like feat/TASK-123-implement-login, the Skill matches it to the corresponding Notion task and connects them.

What is the best way to ensure traceability between project management tasks and code changes?▼

The best way to ensure traceability between project management tasks and code changes is to establish bidirectional links. This Skill connects Notion tasks to GitHub PRs automatically, reducing manual cross-referencing and ensuring seamless navigation between platforms.

Related Skills

Explore More Software Engineering Skills→
DavidROliverBADavidROliverBA
49

sync-notion-pages

Synchronize Obsidian Markdown notes bidirectionally with Notion pages.

Community
Advanced
ImperialAutomationImperialAutomation
11

update-tracking

Update parent pull request descriptions with current sub-issue statuses via GitHub APIs.

Official
Intermediate
learnzdevelopmenthublearnzdevelopmenthub
1

project-init

Initialize GitHub repositories into the Paadhai pipeline with .paadhai.json configuration.

Community
Advanced
abdullahbeamabdullahbeam
2

learn-integrations

Teach users to connect Nexus to external tools via the Model Context Protocol.

Community
Intermediate