comment-writer

Write warm, direct collaboration comments for PRs, issues, and reviews.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill comment-writer-carloswilliamsr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comment-writer
Source: https://github.com/CarlosWilliamsR/SketchOS/tree/main/.config/opencode/skills/comment-writer
Command: npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill comment-writer-carloswilliamsr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing review feedback and issue replies that are both useful and kind is hard under time pressure, and poorly worded comments slow down collaboration. This Skill provides voice rules, a comment formula, and ready examples so every comment you write is actionable, concise, and respectful. ## Core Features & Use Cases - Voice Rules: Enforces warm, direct, short comments that lead with the actionable point and explain the technical reason behind requested changes. - Comment Formula: Structures feedback as observation, rationale, and concrete next action. - Language Matching: Automatically writes in the target thread's language, with neutral professional Spanish or English by default. - Use Case: When reviewing a teammate's oversized PR, use this Skill to write a polite split request that cites the 400-line budget and proposes a clear ordering of commits. ## Quick Start Write a GitHub review comment asking the author to split PR 42 into smaller commits, keeping the tone warm and direct.

Frequently Asked Questions about comment-writer

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

FAQPage Schema
How do I write better GitHub PR review comments?

Lead with the actionable point instead of recapping the PR, explain the technical reason for any requested change, and keep it to one to three short paragraphs. Focus on the highest-value issue rather than listing every minor preference.

How to ask someone to split a large pull request politely?

State the concrete reason, such as exceeding a 400-line budget, then suggest a specific split order like foundation plus tests first, then integration, then docs. This gives the author a clear path forward without sounding dismissive.

Can I write review comments in Spanish or other languages?

Yes, the Skill matches the target thread's language by default, so a Spanish issue gets a Spanish comment. It uses neutral professional Spanish unless the context or user explicitly requests a regional tone.

What tone should code review feedback use?

Aim for warm and direct, like a thoughtful teammate rather than a corporate bot. Start with the useful point, avoid pile-ons over trivial preferences, and skip em dashes in favor of commas or periods.

When should I not use a comment-writing assistant?

Avoid it for sensitive conversations like performance concerns or conflict resolution where fully personal wording matters. It is designed for routine technical collaboration such as PR feedback, approvals, and issue replies.