Communitygithub.com

bg-szy/TOP-SKILLS

Beads Viewer - Motor de triaje basado en grafos para proyectos Beads. Calcula PageRank, intermediación, ruta crítica y ciclos. Utilice los indicadores --robot-* para agentes de IA.

¿Qué es TOP-SKILLS?

BV (Beads Viewer) es un motor de triaje inteligente para proyectos Beads, diseñado para ser utilizado por desarrolladores y agentes de IA que trabajan con archivos `.beads/beads.jsonl`. A diferencia del análisis directo del archivo JSONL, BV precalcula nueve métricas de grafo (PageRank, intermediación, HITS, ruta crítica, eigenvector, grado, densidad, ciclos y orden topológico) para ofrecer recomendaciones deterministas y planes de ejecución. Su modo robot (`--robot-*`) permite a los agentes de IA obtener respuestas estructuradas en JSON sin lanzar la interfaz interactiva TUI, evitando bloqueos. Es compatible con las CLI `bd` y `bv`, y puede integrarse con herramientas de correo de agente y generación de informes HTML interactivos. Con soporte para filtrado por etiquetas, recetas predefinidas (como `actionable`, `high-impact`, `blocked`) y análisis temporal (`--as-of`), BV reduce drásticamente el coste de contexto para los agentes al proporcionar información de grafo ya calculada y segmentada.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/bv

Preguntar en tu IA favorita

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

Documentación

BV - Beads Viewer

Un motor de triaje basado en grafos para proyectos Beads (.beads/beads.jsonl). Calcula 9 métricas de grafo, genera planes de ejecución y ofrece recomendaciones deterministas. Interfaz TUI para humanos; indicadores robot para agentes de IA.

Por qué BV frente a beads.jsonl sin procesar

Capacidadbeads.jsonl sin procesarModo Robot BV
Consulta"Listar todas las incidencias""Listar los 5 cuellos de botella principales que bloquean el lanzamiento"
Coste de ContextoAlto (lineal con el número de incidencias)Bajo (estructura resumida fija)
Lógica de GrafoEl agente debe calcularlaPrecalculada (PageRank, intermediación, ciclos)
SeguridadEl agente podría pasar por alto ciclosLos ciclos se marcan explícitamente

Utilice BV en lugar de analizar beads.jsonl directamente. Calcula las métricas de grafo de forma determinista.

CRÍTICO: Modo Robot para Agentes

Nunca ejecute bv sin indicadores. Inicia una TUI interactiva que bloqueará su sesión.

Utilice siempre los indicadores --robot-*:

bv --robot-triage        # EL MEGA-COMANDO: empiece aquí
bv --robot-next          # Mínimo: solo la mejor opción
bv --robot-plan          # Pistas de ejecución en paralelo
bv --robot-insights      # Métricas de grafo completas

Las 9 Métricas de Grafo

BV calcula estas métricas para revelar dinámicas ocultas del proyecto:

MétricaQué MideInformación Clave
PageRankImportancia recursiva de dependenciasBloqueadores fundamentales
IntermediaciónTráfico de caminos más cortosCuellos de botella y puentes
HITSDualidad Hub/AutoridadÉpicas vs utilidades
Ruta CríticaCadena de dependencias más largaPiedras angulares con margen cero
EigenvectorInfluencia a través de vecinosDependencias estratégicas
GradoConteo de conexiones directasBloqueadores/bloqueados inmediatos
DensidadRelación aristas/nodosSalud de acoplamiento del proyecto
CiclosDependencias circularesErrores estructurales (¡debe arreglarse!)
Orden TopológicoOrden de ejecución válidoBase de la cola de trabajo

Análisis en Dos Fases

BV utiliza computación asíncrona con tiempos de espera:

  • Fase 1 (instantánea): grado, orden topológico, densidad
  • Fase 2 (tiempo de espera de 500ms): PageRank, intermediación, HITS, eigenvector, ciclos

Verifique siempre el campo status en la salida. Para grafos grandes (>500 nodos), algunas métricas pueden ser approx o skipped.

Referencia de Comandos Robot

Triaje y Planificación

bv --robot-triage              # Triaje completo: recomendaciones, ganancias rápidas, bloqueadores a eliminar
bv --robot-next                # Única mejor opción con comando de reclamación
bv --robot-plan                # Pistas de ejecución en paralelo con listas de desbloqueo
bv --robot-priority            # Detección de desalineación de prioridades

Análisis de Grafo

bv --robot-insights            # Métricas completas: PageRank, intermediación, HITS, ciclos, etc.
bv --robot-label-health        # Salud por etiqueta: saludable|advertencia|crítico
bv --robot-label-flow          # Matriz de flujo de dependencias entre etiquetas
bv --robot-label-attention     # Etiquetas ordenadas por atención

Historial y Cambios

bv --robot-history             # Correlaciones bead-commit
bv --robot-diff --diff-since <ref>  # Cambios desde la referencia

Otros Comandos

bv --robot-burndown <sprint>   # Burndown del sprint, cambios de alcance
bv --robot-forecast <id|all>   # Predicciones de ETA
bv --robot-alerts              # Incidencias estancadas, cascadas de bloqueo
bv --robot-suggest             # Higiene: duplicados, dependencias faltantes, ruptura de ciclos
bv --robot-graph               # Exportación de grafo de dependencias (JSON, DOT, Mermaid)
bv --export-graph <file.html>  # Visualización HTML interactiva autocontenida

Alcance y Filtrado

bv --robot-plan --label backend              # Limitar al subgrafo de la etiqueta
bv --robot-insights --as-of HEAD~30          # Punto histórico en el tiempo
bv --recipe actionable --robot-plan          # Prefiltro: listo para trabajar
bv --recipe high-impact --robot-triage       # Prefiltro: PageRank más alto
bv --robot-triage --robot-triage-by-track    # Agrupar por pistas de trabajo en paralelo
bv --robot-triage --robot-triage-by-label    # Agrupar por dominio

Recetas Integradas

RecetaPropósito
defaultTodas las incidencias abiertas ordenadas por prioridad
actionableListo para trabajar (sin bloqueadores)
high-impactPuntuaciones PageRank más altas
blockedEsperando dependencias
staleAbiertas pero sin tocar durante 30+ días
triageOrdenadas por puntuación de triaje calculada
quick-winsElementos P2/P3 fáciles sin bloqueadores
bottlenecksNodos con alta intermediación

Estructura de Salida del Robot

Todo JSON de robot incluye:

  • data_hash - Huella digital de beads.jsonl (verificar consistencia)
  • status - Estado por métrica: computed|approx|timeout|skipped
  • as_of / as_of_commit - Presente cuando se usa --as-of

Salida de --robot-triage

{
  "quick_ref": { "open": 45, "blocked": 12, "top_picks": [...] },
  "recommendations": [
    { "id": "bd-123", "score": 0.85, "reason": "Desbloquea 5 tareas", "unblock_info": {...} }
  ],
  "quick_wins": [...],
  "blockers_to_clear": [...],
  "project_health": { "distributions": {...}, "graph_metrics": {...} },
  "commands": { "claim": "bd claim bd-123", "view": "bv --bead bd-123" }
}

Salida de --robot-insights

{
  "bottlenecks": [{ "id": "bd-123", "value": 0.45 }],
  "keystones": [{ "id": "bd-456", "value": 12.0 }],
  "influencers": [...],
  "hubs": [...],
  "authorities": [...],
  "cycles": [["bd-A", "bd-B", "bd-A"]],
  "clusterDensity": 0.045,
  "status": { "pagerank": "computed", "betweenness": "computed", ... }
}

Referencia Rápida de jq

bv --robot-triage | jq '.quick_ref'                        # Resumen de un vistazo
bv --robot-triage | jq '.recommendations[0]'               # Mejor recomendación
bv --robot-plan | jq '.plan.summary.highest_impact'        # Mejor objetivo de desbloqueo
bv --robot-insights | jq '.status'                         # Verificar preparación de métricas
bv --robot-insights | jq '.cycles'                         # Dependencias circulares (¡debe arreglarse!)
bv --robot-label-health | jq '.results.labels[] | select(.health_level == "critical")'

Patrón de Flujo de Trabajo del Agente

# 1. Empezar con triaje
TRIAGE=$(bv --robot-triage)
NEXT_TASK=$(echo "$TRIAGE" | jq -r '.recommendations[0].id')

# 2. Verificar ciclos primero (errores estructurales)
CYCLES=$(bv --robot-insights | jq '.cycles')
if [ "$CYCLES" != "[]" ]; then
  echo "Arreglar ciclos primero: $CYCLES"
fi

# 3. Reclamar la tarea
bd claim "$NEXT_TASK"

# 4. Trabajar en ella...

# 5. Cerrar cuando esté listo
bd close "$NEXT_TASK"

Vistas TUI (para Humanos)

Al ejecutar bv de forma interactiva (no para agentes):

TeclaVista
lVista de lista (predeterminada)
bTablero Kanban
gVista de grafo (DAG de dependencias)
EVista de árbol (jerarquía padre-hijo)
iPanel de información (6 paneles de métricas)
hVista de historial (correlación bead-commit)
aPlan accionable (pistas en paralelo)
fMatriz de flujo (dependencias entre etiquetas)
]Vista de atención (ranking de prioridad de etiquetas)

Integración con la CLI bd

BV lee de .beads/beads.jsonl creado por la CLI bd:

bd init                    # Inicializar beads en el proyecto
bd create "Título de la tarea"     # Crear un bead
bd list                    # Listar beads
bd ready                   # Mostrar beads accionables
bd claim bd-123            # Reclamar un bead
bd close bd-123            # Cerrar un bead

Integración con el Correo del Agente

Utilice los IDs de bead como IDs de hilo para la coordinación:

file_reservation_paths(..., reason="bd-123")
send_message(..., thread_id="bd-123", subject="[bd-123] Empezando...")

Formatos de Exportación de Grafo

bv --robot-graph                              # JSON (predeterminado)
bv --robot-graph --graph-format=dot           # Graphviz DOT
bv --robot-graph --graph-format=mermaid       # Diagrama Mermaid
bv --robot-graph --graph-root=bd-123 --graph-depth=3  # Subgrafo
bv --export-graph report.html                 # HTML interactivo

Viaje en el Tiempo

Comparar contra estados históricos:

bv --as-of HEAD~10                    # Hace 10 commits
bv --as-of v1.0.0                     # En una etiqueta
bv --as-of "2024-01-15"               # En una fecha
bv --robot-diff --diff-since HEAD~30  # Cambios en los últimos 30 commits

Errores Comunes

ProblemaSolución
La TUI bloquea al agenteUtilice solo indicadores --robot-*
Métricas obsoletasVerifique el campo status, resultados cacheados por data_hash
Ciclos faltantesEjecute --robot-insights, verifique .cycles
Recomendaciones incorrectasUtilice --recipe actionable para filtrar a trabajo listo

Notas de Rendimiento

  • Métricas de Fase 1 (grado, topo, densidad): instantáneas
  • Métricas de Fase 2 (PageRank, intermediación, etc.): tiempo de espera de 500ms
  • Resultados cacheados por data_hash
  • Prefiera --robot-plan sobre --robot-insights cuando la velocidad importe

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

Skills relacionados