issue-verify

Verify issue identifiers in commits, PRs, changelogs, and docs via adapter endpoints.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill issue-verify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-verify
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/issue-tracking/issue-verify
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill issue-verify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents referencing non-existent, mis-typed, or incorrectly typed issue identifiers in commit messages, pull requests, documentation, and changelogs by requiring verification before citation and blocking unsafe references.

Core Features & Use Cases

  • Exact identifier verification using adapter get_issue to confirm existence and entityType before citing an identifier.
  • URL and cross-reference validation using verify_link and follow-up get_issue calls to fetch title and status when needed.
  • Policy enforcement and safety that hard-blocks non-issue entityTypes, warns on ambiguous results, and requires explicit user confirmation for unknown or permission-limited responses.
  • Batch verification reports for changelogs, sprint summaries, and migration tasks that surface not-found identifiers.

Quick Start

Verify PROJ-123 exists and is an issue before adding it to your commit message.

Frequently Asked Questions about issue-verify

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

FAQPage Schema
How do I verify issue identifiers exist before referencing them in a commit message?

To verify issue identifiers before referencing them in commit messages, you need an adapter providing get_issue, verify_link, and search_issues endpoints. The Skill confirms existence and entityType, hard-blocking non-issue references to prevent broken citations.

How can I validate tracker IDs and issue URLs in a changelog or pull request?

Validating tracker IDs and issue URLs in changelogs or pull requests uses the adapter's verify_link endpoint alongside get_issue calls. This fetches title and status data, requiring explicit user confirmation for unknown or permission-limited responses before allowing citation.

Can I check multiple issue references at once for a sprint summary or migration report?

You can batch verify multiple issue references for sprint summaries and migration reports. The Skill surfaces not-found identifiers from the tracker, ensuring bulk reports only cite verified issues that return a valid exists status and entityType.

Do I need a specific issue tracking adapter to use issue identifier verification?

Yes, issue identifier verification requires an adapter that provides get_issue, verify_link, and search_issues endpoints. These endpoints must return exists and entityType fields, enabling the Skill to enforce hard-blocks on non-issue entities and warn on ambiguous results.

What happens when issue verification returns an ambiguous or unknown result?

When issue verification returns an ambiguous or unknown result, the Skill warns the user and requires explicit confirmation before proceeding. It hard-blocks references to non-issue entityTypes entirely, preventing incorrect or mis-typed identifiers from entering documentation.

Why should I block non-issue entityTypes when verifying issue references?

Blocking non-issue entityTypes during issue verification prevents referencing incorrect tracker entries like epics or sub-tasks. The adapter returns entityType data, allowing the Skill to hard-block unsafe references and ensure only valid issues are cited in documentation and commit messages.