Communitygithub.com

ASoudy/AGS

Genera herramientas estructuradas de apoyo a la toma de decisiones: guías paso a paso, verificadores de sesgos, exploradores de escenarios y paneles interactivos. Úsalo ante decisiones importantes que requieran un análisis sistemático. Compatible con múltiples estilos cognitivos y formatos de salida.

¿Qué es AGS?

Este skill, **ASoudy/AGS** (Decision Toolkit), transforma decisiones complejas en herramientas interactivas y estructuradas. A diferencia de un analista que decide por el usuario, el skill guía al humano a través de un proceso sistemático, iluminando el espacio de decisión. Es útil para evaluar oportunidades, asignar recursos, analizar riesgos o navegar concesiones. El skill genera cuatro formatos principales: una guía HTML interactiva (paso a paso, accesible), un marco Markdown offline, un resumen de voz, y un informe PDF profesional. Su filosofía se basa en principios como "guiar, no decidir" y "reducir la carga cognitiva", e incluye consideraciones de accesibilidad (lectores de pantalla, navegación por teclado, alto contraste) e inclusividad cognitiva (estilos analítico, intuitivo, visual, verbal, secuencial y global). El skill ofrece marcos específicos como la prueba de primeros principios, la lista de verificación de sesgos, la matriz de escenarios y el pre-mortem, todos diseñados para hacer explícitos los sesgos y facilitar una decisión informada.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/decision-toolkit

Preguntar en tu IA favorita

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

Documentación

Kit de Herramientas para la Toma de Decisiones

Resumen

Crea materiales estructurados de apoyo a la toma de decisiones que ayudan a los humanos a pensar sistemáticamente en elecciones importantes. Este skill produce herramientas interactivas, no solo análisis, empoderando a quien toma la decisión en lugar de decidir por él.

Filosofía

Principios

  1. Guía, no decidas — Las herramientas iluminan el espacio de decisión; los humanos eligen.
  2. Una cosa a la vez — Reduce la carga cognitiva mediante revelación progresiva.
  3. Múltiples lentes — Una misma decisión vista desde diferentes marcos revela puntos ciegos.
  4. Sesgos visibles — Haz explícitos los sesgos cognitivos y verificables.
  5. Resultados accionables — Termina con pasos concretos, no conclusiones abstractas.

Accesibilidad Primero

  • Compatible con lectores de pantalla (HTML semántico, etiquetas ARIA).
  • Navegable por teclado (orden de tabulación, estados de foco).
  • Alto contraste por defecto (mínimo WCAG AA).
  • Opción de movimiento reducido.
  • Funciona sin JavaScript (degradación gradual).
  • Objetivos táctiles adaptados a móviles (mínimo 44 px).

Inclusividad Cognitiva

Diferentes personas procesan las decisiones de manera diferente:

EstiloAdaptación
AnalíticoNúmeros, matrices, puntuaciones ponderadas.
IntuitivoPreguntas de verificación visceral, "¿cómo te sientes?".
VisualDiagramas, barras de progreso, códigos de color.
VerbalResúmenes escritos, preguntas guía.
SecuencialFlujo de asistente paso a paso.
GlobalVista de panel de control general.

Cuándo Usarlo

Invoca este skill cuando el usuario se enfrente a:

  • Decisiones de colaboración/asociación.
  • Cambios de carrera o trabajo.
  • Inversión significativa de tiempo/dinero.
  • Priorización de proyectos.
  • Selección de tecnología/herramientas.
  • Cualquier elección con múltiples factores e incertidumbre.

No para: Decisiones triviales, respuestas de emergencia o cuando el usuario solo necesita información.

Tipos de Decisión

Tipo 1: Evaluación de Oportunidades

¿Debería aprovechar esta oportunidad?

  • Asociación, oferta de trabajo, inversión, proyecto.

Tipo 2: Asignación de Recursos

¿Dónde debería invertir mi tiempo/dinero/atención?

  • Priorización, presupuestos, áreas de enfoque.

Tipo 3: Evaluación de Riesgos

¿Qué podría salir mal y vale la pena?

  • Nuevos emprendimientos, cambios, experimentos.

Tipo 4: Navegación de Concesiones

¿Qué opción entre alternativas?

  • Selección de herramientas, decisiones de contratación, elecciones estratégicas.

El Viaje de la Decisión

Nueve pasos, cada uno enfocado en una dimensión:

┌─────────────────────────────────────────────────────────────┐
│  1. CONTEXTO         ¿Cuál es la decisión?                  │
│  2. PRIMEROS PRINCIPIOS  ¿Esto resuelve un problema real?   │
│  3. MOMENTO          ¿Es ahora el momento adecuado?         │
│  4. INTERESADOS      ¿Quién más está involucrado?           │
│                       ¿Son estables?                        │
│  5. SESGOS           ¿Qué podría nublar mi juicio?          │
│  6. COSTE DE OPORTUNIDAD  ¿A qué estoy renunciando?         │
│  7. ESCENARIOS       ¿Qué podría pasar?                     │
│  8. PREGUNTAS        ¿Qué necesito aprender aún?            │
│  9. SÍNTESIS         Resumen + decisión                     │
└─────────────────────────────────────────────────────────────┘

Formatos de Salida

1. Guía HTML Interactiva (Principal)

Asistente paso a paso con:

  • Indicador de progreso.
  • Una pregunta por pantalla.
  • Persistencia del estado entre pasos.
  • Resumen final que agrupa todas las entradas.
  • Navegación por teclado.
  • CSS optimizado para impresión.

2. Marco Markdown

Para uso sin conexión o basado en texto:

  • Preguntas estructuradas.
  • Auditoría de sesgos en formato lista de verificación.
  • Plantillas para rellenar.

3. Resumen de Voz

Para consumo en audio:

  • Resumen ejecutivo de 5 a 7 párrafos.
  • Marcado Orpheus TTS para matices emocionales.
  • Decisión clave + fundamento.

4. Informe PDF

Para documentación/uso compartido:

  • Formato profesional.
  • Todos los marcos aplicados.
  • Apéndice con análisis en bruto.

Referencia de Marcos

Prueba de Primeros Principios

1. ¿Qué problema resuelve esto?
2. ¿Puedo resolverlo yo mismo?
3. ¿Es esta la mejor solución?
4. ¿Qué suposiciones estoy haciendo?
5. Si empezara de cero hoy, ¿elegiría esto?

Lista de Verificación de Sesgos

□ FOMO — ¿Tengo miedo de perderme algo?
□ Coste Hundido — ¿Estoy considerando la inversión pasada?
□ Autoridad — ¿Estoy delegando en credenciales?
□ Prueba Social — ¿Estoy siguiendo a la multitud?
□ Compromiso — ¿Me siento atado por declaraciones anteriores?
□ Optimismo — ¿Estoy asumiendo que los problemas se resolverán solos?
□ Reciente — ¿Estoy dando demasiado peso a eventos recientes?
□ Confirmación — ¿Estoy buscando solo información que valide mi postura?
□ Objeto Brillante — ¿La novedad me está distrayendo?
□ Aversión a la Pérdida — ¿Estoy dando demasiado peso a las pérdidas potenciales?

Calculadora de Coste de Oportunidad

Horas/semana × Semanas × Tarifa por hora = Coste directo
+ ¿Qué más podrían producir esas horas?
+ ¿Qué relaciones/oportunidades podrían verse afectadas?
= Coste de oportunidad real

Matriz de Escenarios

| Escenario | Probabilidad | Resultado | Valor Esperado |
|-----------|--------------|-----------|----------------|
| Peor      | X%           | ...       | ...            |
| Malo      | X%           | ...       | ...            |
| Neutral   | X%           | ...       | ...            |
| Bueno     | X%           | ...       | ...            |
| Mejor     | X%           | ...       | ...            |

Pre-mortem

Imagina que es [fecha futura]. Esta decisión fracasó. ¿Por qué?

Posibles causas:
1. ...
2. ...
3. ...

¿Qué causas están bajo mi control?
¿Qué señales de advertencia debería observar?

Marco 10-10-10

¿Cómo me sentiré respecto a esta decisión dentro de:
- 10 minutos?
- 10 meses?
- 10 años?

Minimización del Arrepentimiento

Imagina que tienes 80 años y miras atrás.
¿Te arrepentirías de haber hecho esto?
¿Te arrepentirías de NO haber hecho esto?

Guía de Implementación

Paso 1: Recopilar Contexto

Pregunta al usuario:

  • ¿Cuál es la decisión?
  • ¿Cuáles son las opciones?
  • ¿Cuál es el plazo?
  • ¿Qué está en juego?
  • ¿Algún antecedente relevante?

O extráelo de documentos existentes (transcripciones de reuniones, notas).

Paso 2: Elegir Formato de Salida

Según la preferencia del usuario y el contexto:

  • Decisión compleja + tiempo disponible → HTML interactivo.
  • Análisis rápido → Marco Markdown.
  • Consumo sobre la marcha → Resumen de voz.
  • Necesidad de compartir con otros → Informe PDF.

Paso 3: Generar Herramienta

Usa las plantillas en el directorio templates/:

  • decision-guide-template.html — Asistente interactivo completo.
  • decision-framework.md — Análisis basado en texto.
  • decision-voice-summary.md — Plantilla de guión de audio.

Paso 4: Personalizar

Reemplaza los marcadores:

  • {{DECISION_TITLE}} — Lo que se está decidiendo.
  • {{CONTEXT}} — Información de antecedentes.
  • {{OPTIONS}} — Opciones disponibles.
  • {{STAKEHOLDERS}} — Personas/equipos involucrados.
  • {{TIMELINE}} — Fechas relevantes.
  • {{FACTORS}} — Criterios clave de evaluación.

Paso 5: Aplicar Marca (Opcional)

Si se usa la marca Agency:

  • Importa las variables CSS del skill brand-agency.
  • Usa estilo neobrutalista.
  • Aplica la tipografía Geist/EB Garamond.

Implementación de Accesibilidad

HTML Semántico

<main role="main" aria-label="Guía de Decisión">
  <nav aria-label="Progreso">
    <ol role="list">...</ol>
  </nav>
  <section aria-labelledby="step-title">
    <h1 id="step-title">...</h1>
  </section>
</main>

Navegación por Teclado

// Asegúrate de que todos los elementos interactivos sean enfocables
// El orden de tabulación sigue el orden visual
// Enter/Espacio activan los botones
// Las teclas de flecha navegan por las opciones

Anuncios para Lectores de Pantalla

<div role="status" aria-live="polite" id="announcer">
  <!-- Anuncia cambios de paso, selecciones, resultados -->
</div>

Contraste de Color

/* Mínimo 4.5:1 para texto normal, 3:1 para texto grande */
--text-on-light: #000000;  /* 21:1 sobre blanco */
--text-on-dark: #ffffff;   /* 21:1 sobre negro */
--text-on-primary: #ffffff; /* Verifica cada color */

Movimiento Reducido

@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}

Consideraciones Culturales

Enfoque Individualista

  • "¿Qué QUIERES TÚ?"
  • Metas y valores personales.
  • Coste de oportunidad individual.

Enfoque Colectivista

  • "¿Cómo afecta esto a tu equipo/familia?"
  • Implicaciones en las relaciones.
  • Consideraciones de armonía grupal.

Conciencia de la Distancia de Poder

  • Algunas culturas delegan en figuras de autoridad.
  • La verificación de sesgos debería incluir "¿Estoy delegando inapropiadamente?".
  • Incluye explícitamente las perspectivas de los interesados.

Tolerancia a la Incertidumbre

  • Algunos prefieren un análisis detallado de escenarios.
  • Otros lo encuentran ansioso.
  • Ofrece tanto vistas detalladas como simplificadas.

Ejemplos de Invocación

A partir de una Transcripción de Reunión

Usuario: Analiza esta transcripción de reunión y crea un kit de herramientas de decisión.
Claude: [Extrae la decisión, interesados y opciones de la transcripción]
        [Genera una guía HTML interactiva]
        [Crea un resumen de voz]

Desde Cero

Usuario: Necesito decidir si aceptar una nueva oferta de trabajo.
Claude: [Hace preguntas aclaratorias]
        [Genera un marco de decisión]
        [Personaliza para el tipo de decisión profesional]

Análisis Rápido

Usuario: Ayúdame a pensar en esta decisión de asociación, solo dame los marcos.
Claude: [Proporciona el marco Markdown]
        [Omite la herramienta interactiva]
        [Se centra en las preguntas clave]

Archivos

  • SKILL.md — Este archivo.
  • templates/decision-guide-template.html — Plantilla de asistente interactivo.
  • templates/decision-framework.md — Plantilla de análisis basado en texto.
  • templates/decision-voice-summary.md — Plantilla de guión de audio.
  • references/bias-encyclopedia.md — Descripciones detalladas de sesgos.
  • references/framework-deep-dives.md — Explicaciones extendidas de los marcos.

Integración

Funciona bien con:

  • brand-agency — Aplica marca visual.
  • transcript-analyzer — Extrae decisiones de reuniones.
  • pdf-generation — Crea informes compartibles.
  • elevenlabs-tts — Genera resúmenes de audio.

Aprendizajes

2026-01-09

Contexto: Creación inicial del skill a partir de la sesión de decisión de Synthius.

Insight Clave: El panel que lo muestra todo a la vez abruma. El asistente paso a paso con un concepto por pantalla mejora drásticamente la usabilidad.

Arquitectura: Viaje de 9 pasos que cubre todas las dimensiones principales de la decisión. El objeto de estado persiste las selecciones entre pasos. El resumen agrupa todo.

Nota de Accesibilidad: El neobrutalismo de alto contraste en realidad ayuda a la accesibilidad: bordes claros, estados distintos, sin degradados sutiles.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

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.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados