Communitygithub.com

charlieviettq/awesome-agent-skill

Panel de cola de sólo lectura para ship consciente del workspace (gstack).

¿Qué es awesome-agent-skill?

Esta skill proporciona un panel de control de cola de versiones de solo lectura para el sistema gstack. Permite a los agentes AI y desarrolladores ver qué espacios de versión (VERSION slots) están actualmente reclamados por PRs abiertos, qué workspaces de Conductor tienen trabajo en progreso (WIP) que probablemente se enviará pronto, y qué espacio seleccionaría /ship a continuación. Es una instantánea sin mutaciones, ideal para responder preguntas como "informe de aterrizaje", "qué hay en la cola", "muéstrame los PRs abiertos" o "qué versión reclamo a continuación". Compatible con Claude Code, Cursor y entornos similares que ejecutan skills de Claude, se invoca mediante el comando /landing-report. La skill realiza una serie de comprobaciones de entorno (sesión, modo repositorio, telemetría, etc.) antes de mostrar la información, y maneja la integración con Conductor para sesiones headless o interactivas. También incluye funcionalidades de primera ejecución, como detección de tareas iniciales y configuración de preferencias de usuario.

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

Preguntar en tu IA favorita

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

Documentación

Cuándo invocar esta skill

Muestra qué espacios VERSION están actualmente reclamados por PRs abiertos, qué workspaces de Conductor hermanos tienen WIP que probablemente se enviará pronto, y qué slot /ship seleccionaría a continuación. Sin mutaciones — solo una instantánea. Usar cuando se 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 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"
# Conductor host: AskUserQuestion no es fiable aquí (nativo desactivado, variante MCP
# inestable), por lo que las skills renderizan decisiones como prosa en lugar de llamar a la
# herramienta. Bloqueado en !headless para que una ejecución 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 de la skill
# (ACTIVATED=no, interactiva) para que no esté en la ruta crítica para cada ejecución posterior.
_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"
# Indicación de modo plan para habilidades como /spec que bifurcan el comportamiento según el estado del modo plan.
# Claude Code expone el modo plan a través de recordatorios del sistema; detectamos lo mejor posible
# desde CLAUDE_PLAN_FILE (establecido por el harness cuando el modo plan está activo) y
# recurrimos a "inactive". Los hosts Codex y el modo de ejecución de Claude terminan como
# inactivos, que es el valor predeterminado seguro (por defecto, la canalización de archivo+ejeció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, permitidas porque informan al plan: $B, $D, codex exec/codex review, escrituras en ~/.gstack/, escrituras en el archivo de plan, y open para artefactos generados.

Invocación de habilidades durante el modo plan

Si el usuario invoca una habilidad en modo plan, la habilidad tiene prioridad sobre el comportamiento genérico del modo plan. Trata el archivo de habilidad como instrucciones ejecutables, no como referencia. Síguelo paso a paso comenzando desde el Paso 0; la primera AskUserQuestion hace que el flujo de trabajo entre en modo plan, no es una violación del mismo. AskUserQuestion (cualquier variante — mcp__*__AskUserQuestion o nativa; consulta "Formato AskUserQuestion → Resolución de herramientas") cumple con el requisito de fin de turno del modo plan. Si AskUserQuestion no está disponible o una llamada falla, sigue el respaldo de fallo del Formato AskUserQuestion: headless → BLOQUEADO; interactive → el respaldo en prosa (también cumple con el fin de turno). En un punto STOP, 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 de la habilidad se complete, o si el usuario te dice que canceles la habilidad o salgas del modo plan.

Si PROACTIVE es "false", no invoques ni sugieras habilidades de forma proactiva. Si una habilidad parece útil, pregunta: "Creo que /nombrehabilidad podría ayudar aquí — ¿quieres que la ejecute?"

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

Si la salida muestra UPGRADE_AVAILABLE <antigua> <nueva>: lee ~/.claude/skills/gstack/gstack-upgrade/SKILL.md y sigue el "flujo de actualización en línea" (auto-actualizar si está configurado, de lo contrario AskUserQuestion con 4 opciones, escribe el 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 características.

Descubrimiento de características, máximo un aviso por sesión:

  • Si falta ~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint: AskUserQuestion para commits automáticos de checkpoint continuos. Si se acepta, ejecuta ~/.claude/skills/gstack/bin/gstack-config set checkpoint_mode continuous. Siempre toca el marcador.
  • Si falta ~/.claude/skills/gstack/.feature-prompted-model-overlay: informa "Las superposiciones de modelo están activas. MODEL_OVERLAY muestra el parche." Siempre toca el marcador.

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

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

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

Opciones:

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

Si A: deja explain_level sin establecer (por defecto es default). Si B: ejecuta ~/.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: di "gstack sigue el principio Boil the Ocean — haz la tarea completa cuando la IA hace que el costo marginal sea casi nulo. Lee más: https://garryslist.org/posts/boil-the-ocean" Ofrece abrir:

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

Ejecuta open solo si responde que sí. Ejecuta touch siempre.

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

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

Opciones:

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

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

Si B: pregunta de 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: ejecuta ~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous Si B→B: ejecuta ~/.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: pregunta una vez:

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

Opciones:

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

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

Ejecutar siempre:

touch ~/.gstack/.proactive-prompted

Omitir si PROACTIVE_PROMPTED es yes.

Guía de primera ejecución (una vez)

Si ACTIVATED es no (primera ejecución de habilidad en esta máquina) Y el preámbulo imprimió un valor FIRST_TASK: no vacío que NO sea nongit: muestra UNA línea corta específica del proyecto mapeada desde el token, como aviso, luego CONTINÚA con lo que el usuario haya solicitado realmente — NO detengas su tarea. Mapea el token: greenfield → "Repositorio nuevo — dale 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 no está bien." branch_ahead → "Trabajo no enviado en esta rama — /review y luego /ship." dirty_default → "Cambios sin confirmar — /review antes de confirmar." clean_default → "Elige uno: /spec, /investigate, o /qa." Luego sustituye el token que viste por TASK_TOKEN y ejecuta (mejor esfuerzo), y marca 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, no git, o nada accionable): no muestres nada, solo ejecuta touch ~/.gstack/.activated 2>/dev/null || true.

De lo contrario, si ACTIVATED es yes Y FIRST_LOOP_SHOWN es no: di una vez como aviso (luego continúa):

Consejo: gstack se amortiza cuando completas un ciclo — planificar → revisar → enviar. Un primer ciclo común: /office-hours o /spec para darle forma, /plan-eng-review para cerrarlo, luego /ship.

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

Omite esta sección si tanto ACTIVATED como FIRST_LOOP_SHOWN son yes.

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

Usa AskUserQuestion:

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

Opciones:

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

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


## Skill routing

Cuando la solicitud del usuario coincida con una habilidad disponible, invócala a través de la herramienta Skill. En caso de duda, invoca la habilidad.

Reglas clave de enrutamiento:
- Ideas de producto/lluvia de ideas → 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
- Canalización de revisión completa → invocar /autoplan
- Errores/fallos → invocar /investigate
- Verificar funcionalidad → invocar /qa
- Enviar cambios → invocar /ship
- Ver cola de versiones → invocar /landing-report
- Especificar requisitos → invocar /spec
- Escritura de documentación → invocar /spec
- Revisión de código (PR existente) → invocar /review
- Revisión previa a la confirmación → invocar /review
- Análisis de dependencias → invocar /investigate

Si B: ejecuta ~/.claude/skills/gstack/bin/gstack-config set routing_declined true

Individual skills in this repo

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

Skills relacionados