issue-resolution-report

Write and post structured issue resolution reports as GitHub issue comments or PR descriptions.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/timi-ty/agent-forge --skill issue-resolution-report-timi-ty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-resolution-report
Source: https://github.com/timi-ty/agent-forge/tree/main/skills/issue-resolution-report
Command: npx skills add https://github.com/timi-ty/agent-forge --skill issue-resolution-report-timi-ty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After fixing a bug, engineers often write vague or inconsistent resolution summaries that omit root causes, verification proof, or impact scope. This Skill enforces a rigorous report structure so reviewers and issue trackers get complete, technically sound documentation of what was fixed. ## Core Features & Use Cases - Evidence-first reporting: Requires capturing actual verification output (test results, build logs, before/after behavior) before drafting, with placeholder conventions for UI screenshots. - Standardized report skeleton: Generates a fixed structure covering PR link, root cause summary, per-file change entries (Bug/Purpose, Fix, Impact radius), and a verification block with real terminal output. - Strict writing rules: Bans self-reference, evolution language, and #123 shorthand, enforcing present-tense code-state descriptions and full GitHub URLs. - Use Case: After fixing a rendering bug on a branch, ask the agent to document the fix — it runs the verification command, diffs against the base branch, writes per-file change entries, and posts the report via gh pr edit or gh issue comment. ## Quick Start Ask the agent to write a resolution report for the fix on the current branch and post it as a comment on the GitHub issue.

Frequently Asked Questions about issue-resolution-report

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

FAQPage Schema
How do I write a good bug fix resolution report for a GitHub issue?

A good resolution report states the root cause, lists every changed file with its purpose, fix, and impact radius, and includes a verification block with actual command output. This Skill generates that structure automatically and posts it via the gh CLI.

How to update a GitHub PR description with fix documentation?

Use gh pr edit with the report body to replace the PR description, or gh issue comment to post it as a comment. The Skill provides ready commands including heredoc formatting and cross-repo --repo flags.

Can I include before and after screenshots in a GitHub resolution report?

Agents cannot upload screenshots directly, so the report inserts named image placeholders at the right positions and tells you exactly what to capture. You then take the screenshots and replace the placeholder files in the PR description.

Why should issue reports avoid #123 shorthand references?

GitHub auto-links #N to the current repository, which produces wrong or broken links in cross-repo contexts. The Skill enforces full URLs like https://github.com/owner/repo/issues/123 so references always resolve correctly.

What are the limitations of automated resolution report generation?

The report quality depends on running a real verification step first, since paraphrased proof is banned. Visual fixes still require a human to capture screenshots, and the gh CLI must be installed and authenticated to post.