github/awesome-copilot
Brag Sheet: redacción de declaraciones de impacto respaldadas por evidencia para evaluaciones de desempeño a partir de registros de Git, GitHub y sesiones de Copilot
Acerca de esta habilidad
Una habilidad que convierte la pregunta «¿Qué logré?» en declaraciones de impacto respaldadas por evidencia. Es útil para evaluaciones de desempeño, autoevaluaciones, expedientes de promoción y actualizaciones semanales. Utiliza un formato obligatorio de tres partes: Acción → Resultado → Evidencia. Recupera trabajo olvidado a partir de commits en git, de pull requests mediante gh y de los registros de sesiones de Copilot CLI, si existen. Evita inventar cifras y muestra los borradores al usuario antes de cualquier guardado. Si estas fuentes no están disponibles, recurre a una entrevista guiada con el usuario.
¿Cómo se utiliza esta habilidad?
1. Pide al agente que documente tus logros, por ejemplo: «¿Qué logré en las últimas dos semanas? Quiero preparar mi autoevaluación». También puedes mencionar una categoría específica, como infrastructure.
2. El agente confirma contigo el rango de tiempo y el alcance antes de escanear. Luego verifica las herramientas disponibles: git, gh y las herramientas de la extensión como save_to_brag_sheet, así como la existencia del directorio ~/.copilot/session-state/.
3. El agente escanea las fuentes disponibles: tus commits en el repositorio actual, los pull requests fusionados mediante gh pr list y los archivos workspace.yaml de las sesiones de Copilot. Después agrupa el trabajo relacionado en una sola entrada.
4. El agente redacta entradas en el formato «Acción → Resultado → Evidencia» y las clasifica en categorías como pr, bugfix y oncall. Cualquier entrada a la que le falte evidencia se marca con la frase (evidence needed) y no se elimina.
5. Revisa y edita los borradores. Puedes solicitar un «paquete de evaluación» que seleccione los 3 a 5 logros más importantes, los organice por ejes de impacto y redacte para ellos narrativas con el método STAR.
6. Recibirás texto en formato Markdown agrupado por semana o por eje, listo para pegar en tu documento de evaluación.
Requisitos y limitaciones
- Puede funcionar sin ninguna dependencia mediante la entrevista guiada.
- Herramientas opcionales:
- git para extraer commits del repositorio actual.
- La herramienta gh con una cuenta de GitHub con sesión iniciada para obtener los pull requests.
- Registros de sesiones de GitHub Copilot CLI en ~/.copilot/session-state/, que solo están disponibles para quienes han usado Copilot CLI.
- Las herramientas save_to_brag_sheet, review_brag_sheet y generate_work_log, que solo están disponibles tras instalar la extensión independiente copilot-brag-sheet. El agente no debe invocarlas a menos que haya confirmado que están disponibles.
- Limitaciones:
- La habilidad no inventa métricas ni cifras.
- No captura el trabajo que no deja rastro en git, como la mentoría y los documentos de diseño, salvo mediante la entrevista.
- El escaneo de commits se limita al repositorio actual, salvo que se solicite lo contrario.
- La habilidad está diseñada principalmente para el entorno de Copilot CLI, y la parte de escaneo requiere un agente capaz de ejecutar comandos de terminal.
Instalación según el agente
Descarga y descomprime el ZIP. Contiene la carpeta brag-sheet y el archivo SKILL.md con los adjuntos originales y la licencia.
GitHub Copilot
- Crea esta ruta dentro de tu proyecto si no existe:
.github/skills/ - Copia la carpeta completa de la habilidad en esta ruta:
.github/skills/brag-sheet/SKILL.md - Abre el proyecto en el agente o actualiza la lista y busca brag-sheet.
- Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
Claude Code
- Crea esta ruta dentro de tu proyecto si no existe:
.claude/skills/ - Copia la carpeta completa de la habilidad en esta ruta:
.claude/skills/brag-sheet/SKILL.md - Abre el proyecto en el agente o actualiza la lista y busca brag-sheet.
- Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.
OpenAI Codex
- Crea esta ruta dentro de tu proyecto si no existe:
.agents/skills/ - Copia la carpeta completa de la habilidad en esta ruta:
.agents/skills/brag-sheet/SKILL.md - Abre el proyecto en el agente o actualiza la lista y busca brag-sheet.
- Solicita la tarea del ejemplo y selecciona la habilidad. Concede solo los permisos necesarios.