writing-code-reviews

Draft and refine code review comments for GitHub pull requests.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/blaknite/agent-skills --skill writing-code-reviews
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-code-reviews
Source: https://github.com/blaknite/agent-skills/tree/main/writing-code-reviews
Command: npx skills add https://github.com/blaknite/agent-skills --skill writing-code-reviews

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill streamlines the process of writing constructive and clear code review comments for GitHub pull requests, ensuring feedback is actionable and well-received.

Core Features & Use Cases

  • Collaborative Comment Drafting: Works with the user to refine the wording and tone of review comments.
  • Issue Selection: Allows the user to choose which specific review issues to include as comments.
  • Feedback Principles Integration: Enforces the use of kind and constructive feedback principles.
  • Use Case: After a code review identifies several issues, use this skill to help phrase the comments clearly, suggest code snippets where appropriate, and ensure the feedback is polite and helpful before submitting.

Quick Start

Use the writing-code-reviews skill to draft comments for the pull request number 123.

Frequently Asked Questions about writing-code-reviews

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

FAQPage Schema
How do I draft constructive code review comments for a GitHub pull request?

Draft constructive code review comments for a GitHub pull request by collaboratively selecting specific issues and refining wording to ensure feedback is actionable. This skill enforces kind feedback principles and suggests code snippets before submission.

What's the best way to refine the tone of PR review comments before submitting?

Refine the tone of PR review comments by applying principles of kind feedback during the drafting process. The skill integrates with giving-kind-feedback to adjust structure and wording, ensuring your comments are polite and helpful.

Do I need GitHub CLI installed to write pull request review comments?

Yes, you need GitHub CLI installed to interact with pull requests. The skill requires the gh command-line tool to fetch PR data and apply the collaboratively drafted review comments directly to the repository.

Can I choose which specific code review issues to include in my PR feedback?

Yes, you can choose which specific code review issues to include in your PR feedback. The skill allows you to select individual issues identified during review and then helps phrase clear comments for each selected item.

How does collaborative comment drafting work for GitHub code reviews?

Collaborative comment drafting works by interactively refining the wording of review comments with the user. It helps phrase feedback clearly, suggests appropriate code snippets, and ensures the final comments are constructive and well-received.