# PR Description Writer

Redacta una descripción de pull request clara y estructurada a partir de un diff de...

- Repository: https://github.com/mohitagw15856/pm-claude-skills (1505 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mohitagw15856/pm-claude-skills --skill pr-description-writer -g -a claude-code -y`
Codex: `npx skills add mohitagw15856/pm-claude-skills --skill pr-description-writer -g -a codex -y`
Cursor: `npx skills add mohitagw15856/pm-claude-skills --skill pr-description-writer -g -a cursor -y`
Gemini CLI: `npx skills add mohitagw15856/pm-claude-skills --skill pr-description-writer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add mohitagw15856/pm-claude-skills`

## Description

Redacta una descripción de pull request clara y estructurada a partir de un diff de git, resumen de rama o lista de commits. Úsalo cuando te pidan escribir una descripción de PR, redactar una solicitud de cambios o documentar cambios de código. Produce una descripción con resumen, motivación, cambios realizados, pasos de prueba y orientación para revisores.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Habilidad de Redacción de Descripciones de PR

Redacta descripciones de pull request estructuradas y amigables para revisores a partir de un diff, lista de commits o notas informales. Cubre el qué, por qué y cómo revisar para que los revisores puedan empezar inmediatamente.

## Inputs Requeridos

Solicita estos si no se proporcionan:
- **Qué cambió** (pega un git diff, `git log --oneline`, o describe los cambios en texto plano)
- **Por qué cambió** (el problema que se resuelve o la funcionalidad que se añade)
- **Cómo probarlo** (cualquier paso específico que un revisor necesite para verificar que funciona)
- **Nivel de riesgo** (bajo / medio / alto, afecta cuánta orientación para revisores incluir)
- **Tipo de PR** (feature / bug fix / refactor / dependency upgrade / config change / hotfix)
- **Rama destino** (p. ej. main / develop / release/2.4, afecta el encuadre de riesgo y la orientación para revisores)
- **Issue o ticket vinculado** (p. ej. JIRA-1234, GitHub #567, o "ninguno")

## Formato de Salida

### Título
Un título claro en modo imperativo de menos de 72 caracteres:
`[type]: [descripción concisa de qué cambió]`

Ejemplos:
- `feat: añadir rate limiting a la API pública`
- `fix: resolver race condition en expiración de sesión`
- `refactor: extraer lógica de pagos a PaymentService`

### Resumen
2, 3 oraciones que cubran:
- Qué hace este PR (el cambio)
- Por qué era necesario (el problema u objetivo)
- El enfoque adoptado (a alto nivel)

### Cambios Realizados
Lista con viñetas de cambios específicos, una viñeta por cambio lógico, no por archivo:
- Añadido [X] para manejar [Y]
- Refactorizado [A] para reducir [B]
- Eliminado [C] ya que fue reemplazado por [D]
- Actualizado [E] para corregir [F]

The rest: https://github.com/mohitagw15856/pm-claude-skills/blob/HEAD/i18n/es/skills/pr-description-writer/SKILL.md