Managing GitHub Issue Dependencies

Manage GitHub issue blocking relationships via GraphQL mutations and queries.

1|Updated Jun 4, 2025
One-click install
npx skills add https://github.com/kynoptic/markdownlint-trap --skill managing-github-issue-dependencies
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Managing GitHub Issue Dependencies
Source: https://github.com/kynoptic/markdownlint-trap/tree/main/.claude/skills/gh-issue-dependencies
Command: npx skills add https://github.com/kynoptic/markdownlint-trap --skill managing-github-issue-dependencies

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages GitHub issue blocking/blocked-by relationships using the native dependencies feature via GraphQL API. Use when showing that one issue must complete before another can proceed, querying dependency relationships, or preventing circular dependencies.

Core Features & Use Cases

  • Add blocking relationship: Use GraphQL mutation to set one issue as blocking another
  • Remove blocking relationship: Remove blockers with safety checks
  • Query dependencies: Retrieve current blocking and blocked-by relationships
  • ID handling: Convert issue numbers to node IDs for mutations
  • Best practices: Conservative approach to blocking and lifting
  • Bulk operations: Apply dependencies across multiple issues when needed

Quick Start

Example: Create a blocking relationship between issues #10 (blocked) and #42 (blocking), then query to confirm.

Frequently Asked Questions about Managing GitHub Issue Dependencies

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

FAQPage Schema
How do I set up blocking relationships between GitHub issues?

Use GraphQL mutations to create blocking relationships between issues. Convert issue numbers to node IDs, then apply the addBlockedBy mutation to mark one issue as blocked by another, enforcing ordered work and dependencies across your repository.

Can I query existing issue dependencies in GitHub?

Yes. Query blocking and blocked-by relationships using GraphQL to retrieve current dependency relationships between issues, letting you see which issues are blocking others and which are waiting on completion.

What's the best way to prevent circular dependencies between issues?

The Skill includes circular-dependency prevention logic built into its blocking operations. It validates relationships before applying mutations, stopping you from creating scenarios where issues block each other in a loop.

How do I remove issue dependencies safely?

Use the removeBlockedBy GraphQL mutation with safety checks to lift blocking relationships. The Skill verifies the operation and returns clear output, ensuring you don't accidentally break dependent workflows.

Can I apply dependencies across multiple issues at once?

Yes. The Skill supports bulk operations to apply dependencies across multiple issues in a single workflow, making it efficient to establish complex dependency chains across your repository.

Do I need to convert issue numbers to node IDs for the GraphQL API?

Yes. GitHub's GraphQL API requires node IDs rather than issue numbers for mutations. The Skill handles this conversion automatically, translating issue numbers into the node ID format required for blocking and unblocking operations.