Volver al Workbench
BookSkill.Studio Manual de Outputs
Ir a Generar Skill
Guía Definitiva de Outputs (Paso a Paso para Dummies)

Ya Generé mi Skill... ¿Ahora qué Hago con los Outputs?

Hiciste clic en generar y la app produjo varios archivos y un ZIP descargable. Aquí te explicamos exactamente qué es cada archivo, dónde pegarlo y cómo subirlo a Claude, Antigravity, Codex, Cursor o Perplexity sin enredos técnicos.

Mapa Rápido: ¿Cuál es mi caso?

Elige tu camino
💻 Camino 1: Desarrollador / Terminal

Usas Claude Code, GitHub Copilot CLI o Google Antigravity. Tu archivo clave es el .ZIP descargable. Se instala con un solo comando en tu terminal.

Ver comandos CLI →
🌐 Camino 2: Usuario Web / Sin Terminal

Usas Claude.ai (Web Projects), ChatGPT Plus o Perplexity Spaces. Descomprimes el ZIP en tu PC y subes los archivos .md arrastrándolos con el ratón.

Ver paso a paso web →
⚡ Camino 3: Editor de Código (IDE)

Programas en Cursor, Windsurf, VS Code o Roo Code. Copias SKILL.md a tus reglas del proyecto para que la IA actúe como co-piloto con el libro en mente.

Ver configuración IDE →
1

¿Qué es cada uno de los archivos generados?

Cuando pulsas "Generar Agent Skill", la pantalla central te muestra varios archivos y tienes un botón verde para descargar el ZIP. Esto es lo que significa cada uno y para qué sirve:

1. El archivo nombre-skill.zip (Paquete Completo)

Descargable

¿Qué es? Es toda la habilidad empaquetada con la estructura estándar universal que entienden los agentes de IA modernos.

👉 ¿Qué hago con él?
• Si usas terminal: No necesitas descomprimirlo a mano; lo mueves a tu carpeta de skills con los comandos que te mostramos abajo.
• Si usas la web: Hazle doble clic en tu computadora para descomprimirlo. Verás adentro una carpeta con todos los archivos Markdown (.md) listos para arrastrar.

2. El archivo SKILL.md (El "Cerebro" o Master Prompt)

Núcleo Central

¿Qué es? Es el archivo más importante. Contiene las instrucciones que le dicen a la IA cómo pensar como el autor, qué principios seguir, y un índice que le enseña qué archivo de capítulo abrir cuando hagas una pregunta.

👉 ¿Qué hago con él?
• Cópialo en las Instrucciones del Sistema o Prompt del Proyecto en Claude, ChatGPT o Cursor. La IA adoptará de inmediato la metodología del libro.

3. La carpeta chapters/ (ch01-*.md, ch02-*.md...)

Bajo Demanda

¿Qué es? En lugar de obligar a la IA a leer 400 páginas a la vez, BookSkill dividió el conocimiento en capítulos sintetizados de ~1.000 tokens cada uno.

👉 ¿Qué hago con ellos?
• Súbelos a los archivos de conocimiento de tu proyecto (por ejemplo en Claude Knowledge o Perplexity Space Files). La IA solo los abrirá cuando tu consulta toque ese tema puntual.

4. cheatsheet.md, glossary.md y patterns.md

Consultas Rápidas

¿Qué son?
• cheatsheet.md: Tablas de decisión rápida ("Si tu problema es X → usa la técnica Y").
• glossary.md: Diccionario formal con la terminología exacta del autor para evitar ambigüedades.
• patterns.md: Ejemplos de implementación técnica y anti-patrones (errores graves a evitar).

👉 ¿Qué hago con ellos?
• Son tu "hoja de trucos". Puedes tener el cheatsheet.md abierto en una pestaña de tu navegador o pegarlo en cualquier chat cuando necesites una respuesta rápida de 10 segundos.
2

Guía Detallada: Cómo subir los Outputs a cada IA

CC

Subir a Claude Code (Anthropic CLI)

Si utilizas Claude desde la consola/terminal de tu computadora
100% Automático

Paso 1: Descarga el archivo .zip de BookSkill (ejemplo: ddia-skill.zip).

Paso 2: Abre tu terminal (PowerShell en Windows, Terminal en Mac o Linux) y pega este comando:

Comando para Terminal (reemplaza 'mi-skill' con el nombre de tu archivo): 
# 1. Crear la carpeta en Claude:
mkdir -p ~/.claude/skills/mi-skill

# 2. Descomprimir el archivo descargado dentro:
unzip ~/Downloads/mi-skill.zip -d ~/.claude/skills/mi-skill/

# 3. Abre Claude Code y prueba tu skill:
claude
/mi-skill ¿cuáles son los principios fundamentales del capítulo 3?
CW

Subir a Claude.ai Web (Projects)

Si utilizas Claude desde la página web (claude.ai) en tu navegador
Arrastrar y Soltar
  1. Descomprime el ZIP que descargaste en tu computadora (haz clic derecho → Extraer todo).
  2. Abre tu navegador, entra a claude.ai y haz clic en Projects en el menú lateral izquierdo.
  3. Haz clic en "Create Project" y ponle nombre (ejemplo: "Experto en Sistemas Distribuidos").
  4. En la sección derecha llamada "Project Knowledge", arrastra los archivos que salieron del ZIP:
    • Sube glossary.md, cheatsheet.md, patterns.md y los archivos de la carpeta chapters/.
  5. En la caja de texto llamada "Project Instructions" (Instrucciones del Proyecto), abre tu archivo SKILL.md, copia la sección que dice "🧭 Core Mental Models & Principles" y pégala allí.
  6. ¡Listo! Abre un nuevo chat dentro de ese proyecto y pregúntale cualquier cosa. Claude responderá utilizando el libro como su biblia personal.
AG

Subir a Google Antigravity (CLI / IDE / Agentic System)

Para el asistente y CLI inteligente de Google DeepMind
Nativo

Google Antigravity reconoce automáticamente cualquier habilidad alojada en tu carpeta de usuario ~/.agents/skills/ o en el directorio raíz de cualquier proyecto que estés construyendo:

Comando de instalación: 
# Opción recomendada: Instalar en tus habilidades globales
mkdir -p ~/.agents/skills/mi-libro
unzip ~/Downloads/mi-libro-skill.zip -d ~/.agents/skills/mi-libro/

# En tu siguiente interacción con Antigravity, el agente ya sabrá que la tiene disponible.
GH

Subir a GitHub Copilot CLI & OpenAI Codex

Para desarrolladores que programan con la terminal de Copilot
Copilot Skills

Copilot CLI soporta el estándar abierto de Agent Skills. Solo debes descomprimir en la carpeta ~/.copilot/skills/:

Comando: 
# Crear la carpeta de Copilot e instalar:
mkdir -p ~/.copilot/skills/mi-libro
unzip ~/Downloads/mi-libro-skill.zip -d ~/.copilot/skills/mi-libro/

# Si trabajas en un repositorio de Git para tu equipo:
mkdir -p .github/skills/mi-libro
unzip ~/Downloads/mi-libro-skill.zip -d .github/skills/mi-libro/
CR

Subir a Cursor / Windsurf / VS Code

Para programar con el libro como copiloto en tu editor de código
Rules
  1. Descomprime el ZIP dentro de tu proyecto en la carpeta .cursor/skills/mi-libro/.
  2. Abre tu archivo de configuración de reglas (.cursorrules o en .cursor/rules/reglas.mdc) y copia allí el contenido de SKILL.md.
  3. En el chat de Cursor, puedes invocar directamente el conocimiento escribiendo:
    @SKILL.md ¿cómo aplico el patrón de replicación a mi base de datos?
PX

Subir a Perplexity AI (Spaces)

Para hacer investigación con citas directas del libro
Spaces
  1. En perplexity.ai, haz clic en Spaces y crea uno nuevo.
  2. En el campo Instructions, pega las reglas de SKILL.md y cheatsheet.md.
  3. En la sección Files del Space, sube los archivos de la carpeta chapters/.
  4. Ahora podrás hacer preguntas complejas y Perplexity responderá citando los capítulos exactos del libro.
3

Preguntas Frecuentes sobre los Outputs

¿Tengo que leer todos los archivos generados?

¡No! Los archivos están diseñados para ser leídos por la IA, no para que tú los memorices. Tú solo debes descargar el ZIP y colocarlo en tu herramienta.

¿Puedo modificar o agregar reglas a mano?

Sí. En el Workbench de BookSkill tienes una pestaña llamada "Markdown Crudo" donde puedes cambiar cualquier texto antes de descargar el ZIP, o puedes editar los archivos .md con cualquier editor de texto (Notepad, VS Code, etc.).

¿Qué pasa si mi libro tiene fórmulas o código?

El motor clasifica el documento como "Técnico" y preserva bloques de código, tablas y fórmulas dentro de los capítulos para que la IA los replique con precisión.

¿Cómo sé si la skill funciona antes de instalarla?

Usa el Simulador de Agente integrado en la columna derecha de BookSkill. Escribe una pregunta sobre el libro y verás cómo el agente simula la carga del capítulo exacto en tiempo real.

¿Listo para crear y usar tu primer Skill?

Entra al Workbench, carga tu documento técnico o prueba los presets interactivos de Martin Kleppmann, Rob Fitzpatrick o Will Larson.

Ir al Workbench de BookSkill