Skill Index

ai-agent-camp/

screenshot-annotator

community[skill]

Habilidad que agrega automáticamente anotaciones como recuadros rojos, flechas y globos de texto a capturas de pantalla. Se activa con solicitudes como 'Agregar anotaciones a la captura', 'Agregar flechas a la pantalla', 'Anotaciones para el manual'.

$/plugin install ai-agent-camp

when to use

details

Screenshot Annotator

Agrega anotaciones a capturas de pantalla sin modificar la imagen original. Las anotaciones se superponen encima.

Flujo de trabajo

  1. Analizar la captura de pantalla para identificar el elemento objetivo
  2. Generar superposición de anotaciones usando la API de Gemini Vision
  3. Generar imagen anotada como archivo separado

Uso

python scripts/annotate.py "{ruta_imagen}" "{instrucción}" --style "{estilo}" --text "{etiqueta}" --output "{ruta_salida}"

Parámetros

ParámetroRequeridoPor defectoDescripción
image_path-Ruta a la captura de pantalla
instruction-Qué anotar (ej., "el botón de Inicio de sesión")
--styleNored_boxEstilo de anotación
--textNo-Etiqueta de texto a agregar
--outputNoautoRuta de salida

Estilos

EstiloDescripción
red_boxRectángulo rojo + flecha (por defecto)
arrowFlecha roja apuntando al elemento
calloutGlobo de texto con texto
highlightSuperposición amarilla semitransparente
circleCírculo rojo alrededor del elemento
numberMarcador numerado para pasos

Ejemplos

# Anotación básica
python scripts/annotate.py "login.png" "el botón de Inicio de sesión"

# Con etiqueta de texto
python scripts/annotate.py "settings.png" "el ícono de engranaje" --text "Haga clic aquí"

# Estilo globo de texto
python scripts/annotate.py "form.png" "campo de email" --style callout --text "Ingrese su email"

Requisitos

  • GEMINI_API_KEY o GOOGLE_API_KEY en el entorno
  • Paquetes de Python: google-genai, Pillow, python-dotenv

Descripción general

Habilidad que agrega automáticamente anotaciones como recuadros rojos, flechas, globos de texto y resaltados a capturas de pantalla. Ideal para crear documentación técnica, manuales de usuario y tutoriales.

Solución de problemas

ErrorSolución
API key not foundEstablezca GEMINI_API_KEY o GOOGLE_API_KEY como variable de entorno
Element not found in screenshotDescriba la instruction más específicamente (ej., "el ícono de engranaje en la esquina superior izquierda")

Criterios de éxito

  • Se genera un archivo anotado sin modificar la imagen original
  • Las anotaciones se aplican correctamente al elemento de UI especificado
  • Se completa sin errores

technical

github
minicoohei/ai-agent-camp
stars
358
license
unspecified
contributors
3
last commit
2026-05-25T08:29:07Z
file
.claude/skills/screenshot-annotator/SKILL.es.md

related