Communitygithub.com

charlieviettq/awesome-agent-skill

Panel de control de cola de versiones de solo lectura para un barco con conocimiento del espacio de trabajo (gstack).

¿Qué es awesome-agent-skill?

Este skill de agente de IA proporciona un panel de control de solo lectura para la cola de versiones en entornos gstack, ideal para desarrolladores que trabajan con flujos de trabajo colaborativos basados en espacios de trabajo de Conductor. Muestra qué espacios de versión están reclamados por Pull Requests abiertos, qué espacios de trabajo hermanos tienen trabajo en progreso (WIP) que probablemente se enviará pronto, y qué espacio seleccionaría /ship a continuación. Es útil cuando se le pide al agente un 'informe de aterrizaje', 'qué hay en la cola', 'muéstrame los PRs abiertos' o 'qué versión reclamo a continuación'. El skill no realiza mutaciones, solo proporciona una instantánea del estado actual. Soporta plataformas como Claude Code y Cursor, y se ejecuta mediante un preámbulo de shell que recopila información del entorno, detecta el modo de sesión (interactivo, headless, generado), verifica actualizaciones y gestiona la configuración del usuario. También incluye orientación para la primera ejecución, detección de proyectos, y preguntas sobre telemetría y preferencias de estilo de escritura.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlieviettq/awesome-agent-skill/tree/HEAD/.cursor/skills/gstack/deploy-ship/landing-report

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Cuándo invocar este skill

Muestra qué espacios de VERSIÓN están actualmente reclamados por PRs abiertos, qué espacios de trabajo hermanos de Conductor tienen trabajo en progreso (WIP) que probablemente se enviará pronto, y qué espacio seleccionaría /ship a continuación. Sin mutaciones, solo una instantánea. Úsalo cuando se te pida "informe de aterrizaje", "qué hay en la cola", "muéstrame los PRs abiertos" o "qué versión reclamo a continuación".

/landing-report — Panel de control de cola de versiones

Preámbulo (ejecutar primero)

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true
mkdir -p ~/.gstack/sessions
touch ~/.gstack/sessions/"$PPID"
_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
echo "BRANCH: $_BRANCH"
_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
echo "PROACTIVE: $_PROACTIVE"
echo "PROACTIVE_PROMPTED: $_PROACTIVE_PROMPTED"
echo "SKILL_PREFIX: $_SKILL_PREFIX"
source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
REPO_MODE=${REPO_MODE:-unknown}
echo "REPO_MODE: $REPO_MODE"
_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
case "$_SESSION_KIND" in spawned|headless|interactive) ;; *) _SESSION_KIND="interactive" ;; esac
echo "SESSION_KIND: $_SESSION_KIND"
# Host de Conductor: AskUserQuestion no es confiable aquí (nativo deshabilitado, variante
# MCP inestable), por lo que los skills renderizan decisiones como prosa en lugar de llamar a la
# herramienta. Controlado en !headless para que una ejecución de eval/CI DENTRO de Conductor (GSTACK_HEADLESS)
# aún BLOQUEE en lugar de renderizar prosa a nadie.
if [ "$_SESSION_KIND" != "headless" ] && { [ -n "${CONDUCTOR_WORKSPACE_PATH:-}" ] || [ -n "${CONDUCTOR_PORT:-}" ]; }; then
  echo "CONDUCTOR_SESSION: true"
fi
_ACTIVATED=$([ -f ~/.gstack/.activated ] && echo "yes" || echo "no")
_FIRST_LOOP_SHOWN=$([ -f ~/.gstack/.first-loop-tip-shown ] && echo "yes" || echo "no")
echo "ACTIVATED: $_ACTIVATED"
echo "FIRST_LOOP_SHOWN: $_FIRST_LOOP_SHOWN"
# Detección de proyecto en primera ejecución: ejecutar el detector SOLO en la primera ejecución del skill
# (ACTIVATED=no, interactivo) para que no esté en la ruta crítica para todas las ejecuciones posteriores.
_FIRST_TASK=""
if [ "$_ACTIVATED" = "no" ] && [ "$_SESSION_KIND" != "headless" ]; then
  _FIRST_TASK=$(~/.claude/skills/gstack/bin/gstack-first-task-detect 2>/dev/null || true)
fi
echo "FIRST_TASK: $_FIRST_TASK"
_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
echo "LAKE_INTRO: $_LAKE_SEEN"
_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
echo "TELEMETRY: ${_TEL:-off}"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
if [ "$_EXPLAIN_LEVEL" != "default" ] && [ "$_EXPLAIN_LEVEL" != "terse" ]; then _EXPLAIN_LEVEL="default"; fi
echo "EXPLAIN_LEVEL: $_EXPLAIN_LEVEL"
_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
echo "QUESTION_TUNING: $_QUESTION_TUNING"
mkdir -p ~/.gstack/analytics
if [ "$_TEL" != "off" ]; then
echo '{"skill":"landing-report","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unknown}")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
fi
for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
  if [ -f "$_PF" ]; then
    if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
      ~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
    fi
    rm -f "$_PF" 2>/dev/null || true
  fi
  break
done
eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
_LEARN_FILE="${GSTACK_HOME:-$HOME/.gstack}/projects/${SLUG:-unknown}/learnings.jsonl"
if [ -f "$_LEARN_FILE" ]; then
  _LEARN_COUNT=$(wc -l < "$_LEARN_FILE" 2>/dev/null | tr -d ' ')
  echo "LEARNINGS: $_LEARN_COUNT entries loaded"
  if [ "$_LEARN_COUNT" -gt 5 ] 2>/dev/null; then
    ~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
  fi
else
  echo "LEARNINGS: 0"
fi
~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"landing-report","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
_HAS_ROUTING="no"
if [ -f CLAUDE.md ] && grep -q "## Skill routing" CLAUDE.md 2>/dev/null; then
  _HAS_ROUTING="yes"
fi
_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
echo "HAS_ROUTING: $_HAS_ROUTING"
echo "ROUTING_DECLINED: $_ROUTING_DECLINED"
_VENDORED="no"
if [ -d ".claude/skills/gstack" ] && [ ! -L ".claude/skills/gstack" ]; then
  if [ -f ".claude/skills/gstack/VERSION" ] || [ -d ".claude/skills/gstack/.git" ]; then
    _VENDORED="yes"
  fi
fi
echo "VENDORED_GSTACK: $_VENDORED"
echo "MODEL_OVERLAY: claude"
_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
echo "CHECKPOINT_MODE: $_CHECKPOINT_MODE"
echo "CHECKPOINT_PUSH: $_CHECKPOINT_PUSH"
# Indicador de modo plan para skills como /spec que bifurcan el comportamiento según el estado del modo plan.
# Claude Code expone el modo plan mediante recordatorios del sistema; detectamos de la mejor manera
# desde CLAUDE_PLAN_FILE (establecido por el harness cuando el modo plan está activo) y
# recurrimos a "inactive". Los hosts de Codex y el modo de ejecución de Claude terminan como
# inactive, que es el valor predeterminado seguro (por defecto: pipeline de archivo+ejecución).
if [ -n "${CLAUDE_PLAN_FILE:-}${GSTACK_PLAN_MODE_FORCE:-}" ]; then
  export GSTACK_PLAN_MODE="active"
elif [ "${GSTACK_PLAN_MODE:-}" = "active" ]; then
  export GSTACK_PLAN_MODE="active"
else
  export GSTACK_PLAN_MODE="inactive"
fi
echo "GSTACK_PLAN_MODE: $GSTACK_PLAN_MODE"
[ -n "$OPENCLAW_SESSION" ] && echo "SPAWNED_SESSION: true" || true

Operaciones seguras en modo plan

En modo plan, están permitidas porque informan el plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo de plan, y open para artefactos generados.

Invocación de skill durante el modo plan

Si el usuario invoca un skill en modo plan, el skill tiene prioridad sobre el comportamiento genérico del modo plan. Trata el archivo del skill como instrucciones ejecutables, no como referencia. Síguelo paso a paso comenzando desde el Paso 0; la primera AskUserQuestion marca el flujo de trabajo entrando en modo plan, no una violación del mismo. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; consulta "Formato de AskUserQuestion → Resolución de herramienta") satisface el requisito de fin de turno del modo plan. Si AskUserQuestion no está disponible o una llamada falla, sigue la alternativa de fallo del Formato de AskUserQuestion: headless → BLOQUEADO; interactive → la alternativa de prosa (también satisface fin de turno). En un punto de PARADA, detente inmediatamente. No continúes el flujo de trabajo ni llames a ExitPlanMode allí. Los comandos marcados como "EXCEPCIÓN DE MODO PLAN — EJECUTAR SIEMPRE" se ejecutan. Llama a ExitPlanMode solo después de que el flujo de trabajo del skill se complete, o si el usuario te dice que canceles el skill o que salgas del modo plan.

Si PROACTIVE es "false", no invoques ni sugieras skills de forma proactiva. Si un skill parece útil, pregunta: "Creo que /nombre-del-skill podría ayudar aquí — ¿quieres que lo ejecute?"

Si SKILL_PREFIX es "true", sugiere/invoca nombres /gstack-*. Las rutas de disco permanecen como ~/.claude/skills/gstack/[nombre-del-skill]/SKILL.md.

Si la salida muestra UPGRADE_AVAILABLE <vieja> <nueva>: lee ~/.claude/skills/gstack/gstack-upgrade/SKILL.md y sigue el "Flujo de actualización en línea" (actualización automática si está configurada, de lo contrario AskUserQuestion con 4 opciones, escribe estado de posposición si se rechaza).

Si la salida muestra JUST_UPGRADED <desde> <hasta>: imprime "Ejecutando gstack v{hasta} (¡recién actualizado!)". Si SPAWNED_SESSION es true, omite el descubrimiento de funciones.

Descubrimiento de funciones, máximo un prompt por sesión:

  • Si falta ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion sobre confirmaciones automáticas continuas de checkpoint. Si se acepta, ejecuta ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Tocar el marcador siempre.
  • Si falta ~/.claude/skills/gstack/.feature-prompted-model-overlay: informa "Las superposiciones de modelo están activas. MODEL_OVERLAY muestra el parche." Tocar el marcador siempre.

Después de los prompts de actualización, continúa el flujo de trabajo.

Si WRITING_STYLE_PENDING es yes: pregunta una vez sobre el estilo de escritura:

Los prompts v1 son más simples: glosarios de jerga para primer uso, preguntas enmarcadas en resultados, prosa más corta. ¿Mantener el valor predeterminado o restaurar el conciso?

Opciones:

  • A) Mantener el nuevo valor predeterminado (recomendado — una buena escritura ayuda a todos)
  • B) Restaurar prosa V0 — establecer explain_level: terse

Si A: dejar explain_level sin establecer (por defecto a default). Si B: ejecutar ~/.claude/skills/gstack/bin/gstack-config set explain_level terse.

Ejecutar siempre (independientemente de la elección):

rm -f ~/.gstack/.writing-style-prompt-pending
touch ~/.gstack/.writing-style-prompted

Omitir si WRITING_STYLE_PENDING es no.

Si LAKE_INTRO es no: decir "gstack sigue el principio de Hervir el océano — hacer la tarea completa cuando la IA hace que el costo marginal sea casi cero. Leer más: https://garryslist.org/posts/boil-the-ocean" Ofrecer abrir:

open https://garryslist.org/posts/boil-the-ocean
touch ~/.gstack/.completeness-intro-seen

Ejecutar open solo si es sí. Ejecutar touch siempre.

Si TEL_PROMPTED es no Y LAKE_INTRO es yes: preguntar sobre telemetría una vez mediante AskUserQuestion:

Ayuda a gstack a mejorar. Comparte solo datos de uso: skill, duración, fallos, ID de dispositivo estable. Sin código ni rutas de archivos. El nombre de tu repositorio se registra solo localmente y se elimina antes de cualquier carga.

Opciones:

  • A) ¡Ayuda a gstack a mejorar! (recomendado)
  • B) No, gracias

Si A: ejecutar ~/.claude/skills/gstack/bin/gstack-config set telemetry community

Si B: preguntar seguimiento:

El modo anónimo envía solo uso agregado, sin ID único.

Opciones:

  • A) Claro, el anónimo está bien
  • B) No, gracias, completamente desactivado

Si B→A: ejecutar ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Si B→B: ejecutar ~/.claude/skills/gstack/bin/gstack-config set telemetry off

Ejecutar siempre:

touch ~/.gstack/.telemetry-prompted

Omitir si TEL_PROMPTED es yes.

Si PROACTIVE_PROMPTED es no Y TEL_PROMPTED es yes: preguntar una vez:

¿Dejar que gstack sugiera skills de forma proactiva, como /qa para "¿esto funciona?" o /investigate para errores?

Opciones:

  • A) Mantenerlo activado (recomendado)
  • B) Desactivarlo — escribiré /comandos yo mismo

Si A: ejecutar ~/.claude/skills/gstack/bin/gstack-config set proactive true Si B: ejecutar ~/.claude/skills/gstack/bin/gstack-config set proactive false

Ejecutar siempre:

touch ~/.gstack/.proactive-prompted

Omitir si PROACTIVE_PROMPTED es yes.

Orientación de primera ejecución (una vez)

Si ACTIVATED es no (primera ejecución del skill en esta máquina) Y el preámbulo imprimió un valor FIRST_TASK: no vacío que NO es nongit: mostrar UNA línea corta y específica del proyecto mapeada desde el token, como aviso, luego CONTINUAR con lo que el usuario realmente pidió — NO detener su tarea. Mapear el token: greenfield → "Repositorio nuevo — darle forma primero con /spec o /office-hours." code_node/code_python/code_rust/code_go/code_ruby/code_ios → "Hay código aquí — /qa para verlo funcionar, o /investigate si algo falla." branch_ahead → "Trabajo sin enviar en esta rama — /review luego /ship." dirty_default → "Cambios sin confirmar — /review antes de confirmar." clean_default → "Elige uno: /spec, /investigate o /qa." Luego sustituir el token que viste por TASK_TOKEN y ejecutar (mejor esfuerzo), y marcar como activado:

~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type first_task_scaffold_shown --skill "TASK_TOKEN" --outcome shown 2>/dev/null || true
touch ~/.gstack/.activated 2>/dev/null || true

Si ACTIVATED es no pero FIRST_TASK: está vacío o es nongit (headless, sin git, o nada accionable): no mostrar nada, solo ejecutar touch ~/.gstack/.activated 2>/dev/null || true.

Si no, si ACTIVATED es yes Y FIRST_LOOP_SHOWN es no: decir una vez como aviso (luego continuar):

Consejo: gstack da sus frutos cuando completas un ciclo — planificar → revisar → enviar. Un primer ciclo común: /office-hours o /spec para dar forma, /plan-eng-review para fijarlo, luego /ship.

Luego ejecutar touch ~/.gstack/.first-loop-tip-shown 2>/dev/null || true.

Omitir esta sección si ACTIVATED y FIRST_LOOP_SHOWN son ambos yes.

Si HAS_ROUTING es no Y ROUTING_DECLINED es false Y PROACTIVE_PROMPTED es yes: Verificar si existe un archivo CLAUDE.md en la raíz del proyecto. Si no existe, crearlo.

Usar AskUserQuestion:

gstack funciona mejor cuando el CLAUDE.md de tu proyecto incluye reglas de enrutamiento de skills.

Opciones:

  • A) Agregar reglas de enrutamiento a CLAUDE.md (recomendado)
  • B) No, gracias, invocaré los skills manualmente

Si A: Agregar esta sección al final de CLAUDE.md:


## Enrutamiento de skills

Cuando la solicitud del usuario coincida con un skill disponible, invocarlo mediante la herramienta Skill. En caso de duda, invocar el skill.

Reglas clave de enrutamiento:
- Ideas/lluvia de ideas de producto → invocar /office-hours
- Estrategia/alcance → invocar /plan-ceo-review
- Arquitectura → invocar /plan-eng-review
- Sistema de diseño/revisión de plan → invocar /design-consultation o /plan-design-review
- Tubería de revisión completa → invocar /autoplan
- Errores/fallos → invocar /investigate
- Revisión de código → invocar /review
- Pruebas → invocar /qa
- Envío/despliegue → invocar /ship
- Configuración del proyecto → invocar /office-hours

Ejecutar siempre (independientemente de la elección):

touch ~/.gstack/.routing-declined

Omitir si HAS_ROUTING es yes o ROUTING_DECLINED es true.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados