skills.rest
fractary
fractaryOFFICIAL
Explore all skills by this author →
WebsiteGitHub

spec-linker

Create and maintain bidirectional spec-to-GitHub issue links via comments and descriptions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Maintains bidirectional links between specifications and GitHub items by commenting on issues and updating descriptions.

Core Features & Use Cases

  • Post spec location comments on issues
  • Update PR/issue descriptions with spec links
  • Ensure traceability from spec to work item

Quick Start

Link a generated spec to an issue and reference it from the PR when archival is complete.

Frequently Asked Questions about spec-linker

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

FAQPage Schema
How do I link specifications to GitHub issues and pull requests?▼

spec-linker creates bidirectional links by automatically commenting on GitHub issues and PRs with specification locations. It integrates with spec-generator and spec-archiver to add, update, and maintain those links whenever specifications are created or archived, ensuring traceability from spec to work item.

Can I automatically comment on GitHub issues with spec paths?▼

Yes. spec-linker posts spec location comments on issues and updates PR descriptions with spec links. It avoids duplicate comments and uses the fractary-work plugin to handle all GitHub operations, returning structured outcomes for each linking action.

Does spec-linker work with my existing GitHub workflow?▼

spec-linker integrates with spec-generator and spec-archiver in your workflow. It requires bash and jq and operates through GitHub comments and issue descriptions, making it compatible with standard GitHub-based development practices and bidirectional traceability needs.

What happens when a specification is generated or archived?▼

When spec-generator creates a specification or spec-archiver archives one, spec-linker automatically creates or updates comments on linked issues and updates issue descriptions with spec paths. This maintains synchronization between specifications and work items throughout their lifecycle.

How does spec-linker prevent duplicate comments on GitHub items?▼

spec-linker implements duplicate-avoidance logic by checking existing comments before posting. It ensures only one spec location comment per issue or PR, maintaining clean issue threads while keeping specifications and work items properly linked and traceable.

Related Skills

Explore More Software Engineering Skills→
B0yZ4kr14B0yZ4kr14

speckit-github-issues-link

Link spec.md files to GitHub issues with reverse reference comments.

Community
Intermediate
TasupTasup
2

update-parent-issue-status

Update parent GitHub Issues based on child issue status changes.

Official
Advanced
serejarisserejaris
215

gh-issues

Manage GitHub Issues via gh CLI with JSON and jq scripting.

Community
Advanced
mjamoremjamore

repo-docs

Synchronize repository documentation with source code using doc-first workflows.

Community
Advanced