comment-writer

Standardize technical communication tone and structure for pull requests and issue trackers.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill comment-writer-luisalbertomk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comment-writer
Source: https://github.com/LuisAlbertoMK/gentleman-agent-gh/tree/main/internal/assets/skills/comment-writer
Command: npx skills add https://github.com/LuisAlbertoMK/gentleman-agent-gh --skill comment-writer-luisalbertomk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the friction of writing professional, effective communication for technical collaboration, ensuring your feedback is both kind and actionable.

Core Features & Use Cases

  • Action-Oriented Feedback: Structures comments to prioritize the most important technical points first.
  • Context-Aware Tone: Maintains a warm, teammate-focused persona while adhering to strict brevity rules.
  • Use Case: Use this when reviewing a complex pull request to provide clear, constructive feedback that helps the author improve the code without feeling overwhelmed.

Quick Start

Ask the comment writer to draft a review for the current pull request that suggests splitting the logic into smaller commits.

Frequently Asked Questions about comment-writer

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

FAQPage Schema
How do I write constructive code review feedback for a pull request?

To write constructive code review feedback, structure comments to prioritize key technical points first while maintaining a warm, teammate-focused tone. This approach ensures observations and next actions remain clear, concise, and empathetic.

What is the best way to standardize communication tone across issue trackers and team messaging?

Standardizing communication tone across issue trackers involves enforcing a specific formula for observations and next actions. This ensures consistent professional interaction, facilitating clear and actionable feedback across diverse project contexts and languages.

Can I draft actionable feedback for complex pull requests without overwhelming the author?

Yes, you can draft actionable feedback for complex pull requests without overwhelming the author by enforcing strict brevity rules. This structures comments to prioritize important technical points while maintaining a warm, teammate-focused persona.

Does this approach work for providing feedback across different project contexts and languages?

Yes, this approach works for providing feedback across different project contexts and languages. It standardizes technical communication to ensure consistent professional interaction, facilitating clear and empathetic feedback regardless of the specific platform.

Why use a structured formula for writing GitHub comments instead of freeform text?

Using a structured formula for writing GitHub comments eliminates the friction of writing professional communication. It ensures your feedback is both kind and actionable by prioritizing technical points and adhering to strict brevity rules.

When do I need an action-oriented format for technical collaboration feedback?

You need an action-oriented format for technical collaboration feedback when reviewing complex pull requests or addressing issues. This format ensures clear, constructive feedback that helps authors improve code without feeling overwhelmed.