verify-issue

Verifies pull requests against issue acceptance criteria with mutation testing.

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/sagittaras/agentic-workflow --skill verify-issue-sagittaras
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verify-issue
Source: https://github.com/sagittaras/agentic-workflow/tree/main/skills/verify-issue
Command: npx skills add https://github.com/sagittaras/agentic-workflow --skill verify-issue-sagittaras

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Merging a pull request on trust alone lets unmet acceptance criteria slip through. This Skill independently proves whether a PR actually satisfies every acceptance criterion of its linked issue, instead of relying on checked boxes, PR descriptions, or commit messages. ## Core Features & Use Cases - Criterion-by-criterion verification: Runs the project's configured verification commands, reads cited code precedents, and demands concrete evidence (command output, file:line references) for each acceptance criterion. - Mutation testing of regression tests: Reverts the production change via git and confirms the new regression test actually fails, proving the test guards what it claims. - Tracker integration: Checks off only verified criteria in the issue body and posts a verdict report (Pass / Needs work / Blocked) with a machine-readable "Blokuje merge" line as a PR comment on GitHub or Gitea. - Use Case: In a milestone run, before merging PR #42 that closes issue #38, invoke the Skill to verify each acceptance criterion in an isolated worktree and receive a merge-blocking verdict without touching the working tree. ## Quick Start Verify that PR 42 fulfills the acceptance criteria of its linked issue and post the verdict as a PR comment.

Frequently Asked Questions about verify-issue

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

FAQPage Schema
How do I verify a pull request against issue acceptance criteria?▼

Invoke the Skill with an issue number, PR number, or branch name. It locates the issue-PR pair, checks out the PR branch in an isolated worktree, runs the configured verification commands, and posts a Pass, Needs work, or Blocked verdict as a PR comment.

What is mutation testing of regression tests?▼

Mutation testing reverts the production change with git apply -R and reruns the test suite. If the new regression test still passes with the fix reverted, it guards nothing and the criterion is marked unmet; otherwise the tree is restored and the test must pass again.

Does it work with both GitHub and Gitea?▼

Yes. On GitHub it calls gh-based scripts from the plugin's scripts directory with an explicit -R owner/repo flag. On Gitea it loads a restricted set of mcp__gitea__ tools via ToolSearch, deliberately excluding any PR write or merge capability.

Can the Skill fix issues it finds during verification?▼

No. It is strictly read-only: it never edits code, adds tests, or modifies the PR. Findings are routed as recommendations to implement-issue or triage-issue, keeping the verifier independent from the author of the change.

Why does verification fail with a Blocked verdict?▼

Blocked means verification could not run as a whole: missing workflow configuration, no area label or verification command for the issue, an unresolvable issue-PR pair, an unavailable PR branch (such as fork PRs), or an environment that cannot execute the verification command.

What are the limitations for pull requests from forks?▼

PRs from forks cannot be verified because git fetch only reaches branches of the same repository. The Skill reports this as a structural limitation in the verdict rather than a failure of the PR itself.