issue-linker

Create typed issue relationships via cross-reference comments using the Fractary CLI.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill issue-linker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-linker
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/work/skills/issue-linker
Command: npx skills add https://github.com/fractary/claude-plugins --skill issue-linker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fractary-cli, gh.

What problem does it solve?

This Skill establishes typed relationships between issues (relates_to, blocks, blocked_by, duplicates) using the Fractary CLI, enabling dependency tracking and traceability.

Core Features & Use Cases

  • Relationship types: relates_to, blocks, blocked_by, duplicates
  • Bidirectional linking: Cross-link source and target issues when applicable
  • Automation-friendly: Outputs JSON for programmatic consumption

Quick Start

Link issue 123 to 456 as blocks using the Fractary CLI.

Frequently Asked Questions about issue-linker

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

FAQPage Schema
How do I create typed relationships between GitHub issues?▼

Typed relationships between issues express dependencies using cross-reference comments. Issue-linker establishes relates_to, blocks, blocked_by, and duplicates links via the Fractary CLI, enabling dependency tracking and traceability in GitHub workflows.

Can I automate issue dependency tracking in GitHub?▼

Yes. Issue-linker automates dependency tracking by creating bidirectional cross-links between issues. It requires issue IDs and an optional relationship type, outputs structured JSON, and integrates with GitHub work-item workflows through the Fractary CLI.

What relationship types does issue linking support?▼

Issue-linker supports four relationship types: relates_to (default), blocks, blocked_by, and duplicates. Each type establishes explicit semantic connections between issues for dependency management, duplicate detection, and related-issue discovery.

Do I need special setup to link GitHub issues as dependencies?▼

You need the Fractary CLI and gh installed as dependencies. Issue-linker accepts issue IDs, optional relationship type, and working directory, then enforces input validation before posting cross-reference comments to establish the link.

How does issue-linker handle bidirectional linking?▼

Issue-linker cross-links source and target issues when applicable, creating reciprocal relationships. This bidirectional approach ensures both issues reference each other, maintaining consistency in dependency graphs across your GitHub workflow.

What output does issue-linker provide for automation?▼

Issue-linker emits structured JSON responses, making the output consumable by downstream tools and workflows. This automation-friendly format enables programmatic dependency tracking, status queries, and integration with CI/CD pipelines or issue management systems.