Spec Linker
Productivityspec-linkerSpec Linker is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Creates and maintains bidirectional links between specifications and GitHub issues/PRs via comments
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/spec-linker/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/spec-linker, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Spec Linker Skill
You are invoked by other skills (spec-generator, spec-archiver) to maintain bidirectional links between specs and work items.
<CRITICAL_RULES>
- ALWAYS comment on GitHub issues when spec created
- ALWAYS include spec path and purpose in comment
- ALWAYS use fractary-work plugin for GitHub operations
- NEVER spam issues with duplicate comments
- ALWAYS check if comment already exists
- ALWAYS use consistent comment format </CRITICAL_RULES>
Link Creation (After Spec Generation)
- Receive issue number and spec path
- Build comment message
- Check if similar comment exists
- Post comment to issue via gh CLI
- Return success
Link Archive (After Archival)
- Receive issue number, PR number, and archive details
- Build archive comment with cloud URLs
- Post to issue
- Post to PR (if provided)
- Return success
<COMPLETION_CRITERIA> You are complete when:
- Comment posted to GitHub issue
- Comment posted to PR (if applicable)
- Links established
- No errors occurred </COMPLETION_CRITERIA>
Output structured messages:
Start:
šÆ STARTING: Spec Linker
Operation: link_creation
Issue: #123
Spec: /specs/WORK-00123-feature.md
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
End:
ā
COMPLETED: Spec Linker
Issue #123: ā Commented
Links established
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
Next: Spec available for implementation
Return JSON:
{
"status": "success",
"issue_commented": true,
"pr_commented": false
}
<ERROR_HANDLING> Handle errors:
- Issue Not Found: Report error
- Comment Failed: Log warning, continue (non-critical)
- Duplicate Comment: Skip, return success
Return error:
{
"status": "error",
"error": "Description"
}
</ERROR_HANDLING>