Skills

Las Skills son archivos Markdown que dan al Agent conocimiento profundo y específico de una tarea para un tipo de trabajo concreto. Define una para la creación de relatos cortos, una para analizar un libro, una para dar formato a guiones, y el Agent carga solo la skill relevante para lo que estás haciendo ahora mismo.

Cómo funcionan las skills

Las skills usan carga progresiva para mantener el contexto ligero. Cuando abres un proyecto, el Agent ve una lista de skills disponibles con sus nombres y descripciones, unas pocas docenas de palabras cada una. Eso es todo lo que carga al inicio. Cuando pides algo que coincide con la descripción de una skill, el Agent activa esa skill y carga sus instrucciones completas. Una skill de creación de relatos cortos permanece inactiva mientras trabajas en una carta de consulta. Una skill de ficción de terror no consume contexto cuando estás esbozando un thriller.

Nivel	Cuándo se carga	Contenido
Metadatos	Siempre, al inicio	Nombre y descripción del frontmatter
Instrucciones	Cuando la skill se activa	Cuerpo completo del SKILL.md
Archivos de apoyo	Según se necesiten	Plantillas, scripts, documentos de referencia

Dónde viven las skills

Cada skill es un directorio que contiene un archivo SKILL.md. El nombre del directorio pasa a ser el nombre de la skill. Las skills también pueden incluir archivos de apoyo en tres subdirectorios opcionales.

your-novel/
├── .soloent/
│   └── skills/                  # Skills del proyecto (solo este proyecto)
│       └── short-story/
│           ├── SKILL.md                   # Obligatorio: nombre, descripción, instrucciones
│           ├── templates/                 # Opcional: plantillas de salida, guías de formato
│           │   ├── chapter-outline.md
│           │   └── character-profile.md
│           ├── docs/                      # Opcional: material de referencia, tablas de consulta
│           │   └── genre-conventions.md
│           └── scripts/                   # Opcional: scripts de procesamiento que el Agent puede ejecutar
│               └── word-count.py
├── SOLOENT.md
├── chapters/
└── ...

Los archivos de apoyo se cargan solo cuando las instrucciones los referencian; no consumen contexto al inicio. Una plantilla permanece inactiva hasta que el Agent llega al paso que la requiere. Un documento de referencia se lee solo cuando el Agent necesita consultar algo. Las skills globales se guardan en el directorio de skills a nivel de sistema y están disponibles en todos tus proyectos. Úsalas para capacidades de propósito general que aplicas de forma constante: una skill para generar ganchos de apertura, o una que guíe al Agent por tu proceso estándar de revisión de manuscritos. Las skills del proyecto viven en .soloent/skills/ en la raíz de tu proyecto. Úsalas para capacidades ligadas a un proyecto o género concreto: una skill construida en torno a las reglas particulares de tu serie de romance, o una calibrada al nivel explícito y al registro narrativo de tu historia actual.

Cuando una skill global y una del proyecto comparten el mismo nombre, la del proyecto tiene prioridad.

Activar y desactivar skills

Cada skill tiene un interruptor para activarla o desactivarla sin eliminar el archivo. Desactiva una skill cuando no la necesites para la tarea actual: así se mantiene fuera del contexto y evitas activaciones no deseadas.

Crear una skill

El archivo SKILL.md tiene dos partes: un bloque de frontmatter (metadatos) y el cuerpo de instrucciones.

---
name: my-skill
description: Describe cuándo activar esta skill, no lo que hace.
---

Instrucciones que el Agent debe seguir cuando esta skill se activa.

Dos campos obligatorios del frontmatter:

name debe coincidir exactamente con el nombre del directorio
description describe cuándo activar esta skill, no lo que hace (menos de 1024 caracteres)

Archivo SKILL.md abierto en el editor mostrando los campos de frontmatter name y description, con el panel Skills a la derecha mostrando la skill english-short-story en Workspace Skills

Abre el menú de Skills

Haz clic en el cuarto icono desde la izquierda en el panel del Agent y cambia al gestor de Skills.

Crea una nueva skill

Haz clic en “New skill…”, introduce un nombre (p. ej., short-story) y haz clic en ”+”. El Agent crea un directorio de skill con un archivo SKILL.md de plantilla.

Escribe las instrucciones de la skill

Edita el archivo SKILL.md:

Actualiza la description para especificar cuándo debe activarse esta skill
Añade tus instrucciones, listas de comprobación y pasos del flujo de trabajo en el cuerpo
Opcionalmente añade archivos de apoyo en los subdirectorios templates/ o docs/

Este es el archivo oficial de la skill english-short-story, una skill de tipo experto de dominio con un flujo de trabajo completo de 6 pasos, listas de comprobación y condiciones de parada. Cópiala y pégala directamente.

Obtén la skill english-short-story completa — haz clic para expandir y copiar

---
name: english-short-story
description: A SoloEnt official writing skill. Create English short fiction with strong hooks, sharp reversals, and high emotional intensity using a 6-step workflow: concept brainstorm, character design, outline, chapter writing with auto-review, and optional chapter review and title/hook generation. Explicit scenes and dark emotional registers are available tools, not requirements. Use when writing short stories, drafting chapters, designing characters, building outlines, reviewing fiction chapters, or generating titles and hooks.
---

# English Short Story

Manages the full creation workflow for English short fiction (10–20 chapters, 900–1,200 words each). Designed for stories built on strong hooks, sharp reversals, and high emotional intensity — across any register including thriller, horror, romance, erotic, literary, or hybrid. Explicit scenes and dark emotional content are available tools calibrated per story, not default requirements.

---

## Before Any Task: Read SOLOENT.md

If `SOLOENT.md` exists, read it and extract:

- **Section 8.1 Todo List** — what is the current pending task?
- **Section 7.1 Current Status** — which step/chapter are we on?
- **Section 7.4 Pending Threads** — active hooks and next chapter goal
- **Section 3 Character Index** — is the Character Voice Profile available?

If `SOLOENT.md` does not exist, proceed directly to Step 1. After the user confirms the core concept, run `/init` to create and populate `SOLOENT.md` before Step 2 begins.

---

## Usage

Use this skill whenever you are working on an English short fiction project that prioritizes strong hooks, emotional intensity, and sharp plot reversals. It manages the full creation process from a one-line premise through to finished chapter files. Works across all registers — thriller, horror, romance, erotic, literary, or hybrid. Explicit content level is calibrated per story during Step 1.

**Start a new story**: provide a one-line premise and the skill walks you through Steps 1–4 in sequence, requiring your confirmation at each stage before advancing. Steps 5 and 6 are optional and run on request.

Trigger phrases that activate this flow:
- Direct story ideas: "A woman finds a letter in her dead husband's coat…", "Two strangers trapped in a lighthouse…"
- Intent statements: "I want to write a short story", "I have a story idea", "Let's write a short fiction"
- Explicit skill invocation: "Use the short story skill", "Start the writing workflow", "短篇技能"

**Resume an existing story**: open a project that already has a `SOLOENT.md` and say "continue the story" or "pick up where we left off" — the skill reads current state and resumes from the correct step.

**Jump to a specific step**: name the step directly (e.g. "run Step 4 for Chapter 3", "review Chapter 5") and the skill starts there.

**Prompt templates are optional**: if `templates/Prompt-0X-*.md` files are present the skill loads them; if not, it runs on the built-in instructions and checklists.

---

## The 6-Step Workflow

### Step 1 — Core Concept Brainstorm

**Input**: One-line premise from user
**Output**: Core concept + story arc (3+ reversals + explicit calibration + sensory register)

If `templates/Prompt-01-Core Concept Brainstorm.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Checklist before advancing to Step 2**:
- [ ] Central tension defined (desire / fear / obsession / transgression)?
- [ ] 3+ major plot reversals designed?
- [ ] Erotic / horror / thriller elements are structural, not decorative?
- [ ] Explicit level calibrated and noted?
- [ ] First-person narration viable?

**Wait for user confirmation.**

→ Once confirmed, run `/init` to initialize `SOLOENT.md` before proceeding to Step 2.

---

## /init — Initialize SOLOENT.md

Run automatically after Step 1 is confirmed, before Step 2 begins.

**Actions**:
1. Create `SOLOENT.md` in the project root.
2. Fill in the following fields from the Step 1 output:
   - **Section 1 Project DNA**: genre, core themes, emotional promise
   - **Section 5 Stylistic Guidelines**: base tone, language register, pacing notes derived from concept
   - **Section 7.1 Current Status**: story title, story time, immediate atmosphere
   - **Section 8.1 Todo List**: check off `[x] Confirm core concept (Step 1)`, leave remaining todos open
   - **Section 8.2 Milestone Log**: add `[Completed] Step 1 — core concept confirmed: [premise summary] / explicit level: [X]`
3. Confirm to user: `SOLOENT.md initialized — ready for Step 2.`

---

### Step 2 — Character Design

**Input**: Confirmed core concept
**Output**: Main cast + Character Voice Profile

If `templates/Prompt-02-Character Design.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Rules**:
- Complete and confirm characters **before** touching the outline
- Must output a **Character Voice Profile**: 1–2 sentences per character (speech patterns + signature phrases) — pasted into every Step 4 prompt

**Checklist before advancing to Step 3**:
- [ ] Protagonist is active? Clear goal driving them forward?
- [ ] Every character embodies a value, desire, fear, or moral position?
- [ ] Protagonist's voice is distinct, layered, and evolves?
- [ ] Character Voice Profile output and ready for Step 4?
- [ ] Core cast ≤ 4 characters?
- [ ] Relationships generate natural conflict?

**Wait for user confirmation.**

→ Update `SOLOENT.md`:
- **Section 3.1 Character Index**: add each character entry with name, age, role, and pointer to `characters/[name].md`
- **Section 3.2 Relationship Network**: fill in key relationships
- **Section 7.2 Character Snapshot**: fill in current character states
- **Section 8.1**: check off character design todo, add `[ ] Complete story outline`
- **Section 8.2**: log `[Completed] Step 2 — characters confirmed: [names] / Voice Profile ready`

---

### Step 3 — Outline and Chapter Plan

**Input**: Confirmed concept + confirmed characters + chapter count (default 10–20)
**Output**: 3-act outline + chapter-by-chapter plan

If `templates/Prompt-03-Outline and Chapter Plan.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Chapter plan format** (must match Step 4 input):
- Story beats: 3–5 per chapter
- Intensity peak: note trigger method (dialogue / action / discovery)
- Closing hook: note tension type (reversal / revelation / threat / disappearance)
- No pre-set timestamp transitions

**Checklist before advancing to Step 4**:
- [ ] Chapter count confirmed with user?
- [ ] Chapter 1 opens on immediate conflict?
- [ ] Chapter 1 intensity peak strong enough to lock the reader?
- [ ] Every chapter has: beats + intensity peak (trigger noted) + closing hook (tension type noted)?
- [ ] Reversal points clearly marked?
- [ ] Explicit / horror / thriller peaks distributed throughout, not clustered?

**Wait for user confirmation.**

→ Update `SOLOENT.md`:
- **Section 4.1 Story Structure**: fill in chapter range and act breakdown
- **Section 4.2 Outline Index**: add pointer `[Story Outline] -> outline/master-outline.md`
- **Section 8.1**: check off outline todo, add `[ ] Begin writing Chapter 1`
- **Section 8.2**: log `[Completed] Step 3 — outline confirmed: [X] chapters / [act structure summary]`

---

### Step 4 — Chapter Writing + Auto-Review

**Input**: Current chapter plan + Character Voice Profile; from Chapter 2 onward, also paste previous 1–2 chapters
**Output**: Chapter prose (900–1,200 words) + auto-review report

If `templates/Prompt-04-Chapter Writing.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Per-chapter process**:
1. Chapter 1: paste chapter plan + Voice Profile
2. Chapter 2+: paste chapter plan + Voice Profile + previous 1–2 chapters
3. Run `wc -w chapters/ch-XX.md` for word count — do not use model self-estimate
4. Output auto-review immediately after prose

**Auto-Review Checklist** (run after every chapter, mark ✅/❌):
- [ ] Word count 900–1,200 (verified via `wc -w`)?
- [ ] All beats executed in order? Intensity peak landed with correct trigger?
- [ ] Closing hook sharp? No moral summary / reflection / epiphany ending?
- [ ] First-person POV clean — no "he thought / she felt" violations?
- [ ] No 3+ consecutive introspective sentences?
- [ ] Dialogue drives plot (≥ 50%)?
- [ ] Each character's speech matches their Voice Profile?
- [ ] No repeated phrasing within the same character's lines?
- [ ] No timestamp scene openers ("The next day…" / "Three weeks later…")?
- [ ] Age/occupation/backstory communicated obliquely after first mention?
- [ ] Explicit intensity consistent with Step 1 calibration?
- [ ] No AI tells (mechanical structures, em-dash overuse, clichéd phrasing)?

→ After each chapter, update `SOLOENT.md`:
- **Section 7.1**: update `Current Chapter` to next chapter number
- **Section 7.3 Recent Plot Flow**: replace with 3–5 key events from this chapter
- **Section 7.4 Pending Threads**: update `Urgent Hooks`, `Active Foreshadowing`, `Next Chapter Goal`
- **Section 7.5 Execution Review**: paste auto-review checklist result + word count
- **Section 8.1**: check off current chapter todo, add next chapter todo
- **Section 8.2**: log `[Completed] Ch-[X] written — [one-line plot summary]`

> For deep-dive review of specific chapters, use Step 5 (optional).

---

### Step 5 — Chapter Review (Optional)

**Input**: User-specified chapter(s)
**Output**: Detailed review report + revision recommendations

If `templates/Prompt-05-Chapter Review.md` exists, load and follow it. Otherwise proceed using the checklist below.

**When to trigger**:
- User questions a chapter's quality
- Reversal chapters need tonal polish
- Multi-chapter continuity check needed
- Explicit content consistency review across chapters

**Checklist**:
- [ ] Word count (900–1,200) + outline fidelity (beats + intensity peak)?
- [ ] Narrative logic continuity, prose style consistency, character voice fidelity?
- [ ] ⚠️ Tag repetition: age/occupation ≤ 2 mentions; timestamp openers = 0; no phrase repetition?
- [ ] Explicit escalation correct? Any tonal inconsistencies?
- [ ] No AI tells (mechanical structures, digressive monologues, em-dash overuse)?

→ Update `SOLOENT.md`:
- **Section 7.5 Execution Review**: log review findings and revision status for reviewed chapter(s)
- **Section 8.1**: check off review todo if applicable

---

### Step 6 — Title and Opening Hook (Optional)

**Input**: Completed full story (or concept + key scene summary)
**Output**: 100–150 word opening hook + 3 title options

If `templates/Prompt-06-Title and Hook.md` exists, load and follow it. Otherwise proceed using the output spec and checklist below.

**Run only when user requests.** Recommended after all chapters are complete — extract tension from the actual draft.

**Checklist**:
- [ ] Opening hook is 100–150 words, names core conflict, creates immediate suspense?
- [ ] 3 titles differ in style (conflict angle / intrigue angle / atmosphere angle)?
- [ ] Titles calibrated for English-language fiction platforms?

**Delivery**: individual chapter files + title and hook; merge into single file only if user requests.

→ Update `SOLOENT.md`:
- **Section 7.1**: set `Current Chapter` to `Complete`
- **Section 8.1**: check off Step 6 todo if present
- **Section 8.2**: log `[Completed] Step 6 — title and hook delivered / project complete`

---

## Core Creative Principles

- **Hook before everything**: the opening must create immediate tension — a question, a threat, a desire the reader cannot ignore
- **Emotional intensity over social melodrama**: drive the story with visceral feeling — desire, dread, obsession, grief, rage — not domestic drama for its own sake
- **Escalating stakes**: each act pushes further than the reader expects — in intimacy, danger, revelation, or moral cost
- **Active protagonist**: story engine is what the protagonist *chooses to do*, not what happens to them
- **Characters embody value**: each character represents a desire, a fear, a moral position, a kind of power
- **3+ major reversals** distributed across the full story
- **First-person narration** for maximum immersion
- **Explicit content is a calibrated tool**: level set in Step 1 — can range from zero to high depending on the story's needs

Tres tipos comunes de skill

Tipo 1: de lista de comprobación

Ideal para verificar varios criterios en un punto fijo, para que no se escape nada. Por ejemplo, una comprobación previa a la entrega después de terminar cada capítulo:

---
name: chapter-submission-check
description: Use before finalizing a chapter to verify word count, consistency, and all checklist items.
---

## Comprobación previa a la entrega (todo debe pasar antes de avanzar)
- [ ] Recuento de palabras 900–1200 (verificado con herramienta, no estimado)
- [ ] Todos los beats del capítulo ejecutados, pico de intensidad logrado
- [ ] Gancho final afilado — sin resumen moral ni final reflexivo
- [ ] Comprobación de coherencia de nombres de personajes superada
- [ ] SOLOENT.md actualizado

## Salida
Pasa / No pasa por elemento. Cualquier "No pasa" debe corregirse antes de continuar.

Tipo 2: de flujo de trabajo

Ideal para operaciones con una secuencia fija de pasos y un paso de confirmación antes de ejecutar.

---
name: chapter-rewrite
description: Rewrite a chapter from scratch. Run only when explicitly requested.
---

## Pasos
1. Copia de seguridad: guarda el capítulo actual como ch-XX-original.md para conservar el original
2. Aclara: resume la dirección central de esta reescritura en un párrafo y espera la confirmación del usuario antes de escribir
3. Ejecuta: escribe el capítulo completo en la nueva dirección (900–1200 palabras)
4. Verifica: ejecuta la lista de comprobación del capítulo frente al original y muestra las principales diferencias entre la versión antigua y la nueva

Tipo 3: experto de dominio

Ideal para situaciones en las que quieres que el Agent trabaje a partir de la experiencia de un experto en lugar de adivinar. Por ejemplo, una skill de diagnóstico para cuando la escritura se atasca:

---
name: story-diagnosis
description: Use when a chapter feels flat, pacing is off, or a scene isn't landing.
---

## Recogida de evidencias
1. Lee el texto completo del capítulo problemático
2. Coteja con el plan de beats del capítulo en la Sección 4 de SOLOENT.md
3. Revisa el arco emocional de los capítulos inmediatamente anterior y posterior

## Matriz de decisión
| Síntoma | Comprueba primero |
|---|---|
| El ritmo se arrastra | Densidad de beats / párrafos muertos |
| Planitud emocional | Coherencia de la voz del personaje / demasiado monólogo interno |
| El gancho final falla | Tipo de tensión / si la tensión ya se liberó dentro del capítulo |

## Formato de salida
Causa raíz / alcance del impacto / pasos de corrección / método de verificación

Ejemplo completo: resumen de un libro

Esta es una skill de experto de dominio. Define una ruta de recuperación de contenido (un script extrae capítulos bajo demanda), conocimiento especializado (patrones de reconocimiento de capítulos en docs/) y un formato de salida fijo (una plantilla de notas en templates/): los tres elementos que caracterizan a una skill de experto de dominio. Esta skill extrae notas de lectura estructuradas de un archivo de libro local —resúmenes de capítulos, ideas clave y citas— y las guarda como Markdown con formato.

Estructura de directorios

book-summary/
├── SKILL.md                    # Instrucciones del flujo de trabajo
├── templates/
│   └── note-template.md        # Formato de salida de las notas de lectura
├── docs/
│   └── chapter-patterns.md     # Patrones de encabezado de capítulo para libros en chino e inglés
└── scripts/
    └── analyze-book.py         # Preprocesa los archivos del libro antes de que el Agent los lea

Por qué esta skill necesita un script

Los libros son largos. Cargar una novela entera en el contexto para extraer su estructura de capítulos sería un desperdicio y lento. El script de preprocesamiento lo resuelve:

Comando info — lee las primeras 50 líneas para identificar el título, la codificación y el número total de líneas
Comando chapters — escanea el archivo en busca de encabezados de capítulo y devuelve sus números de línea, sin leer el texto completo
Comando extract — lee solo las líneas de un capítulo concreto, para que el Agent procese un capítulo a la vez

El Agent llama al script en cada etapa del flujo de trabajo. Solo la salida del script entra en el contexto, no el libro en sí.

Por qué esta skill necesita un archivo docs

Los formatos de los encabezados de capítulo varían mucho entre libros en chino e inglés. En lugar de incrustar todos los patrones de reconocimiento en SKILL.md, la skill los guarda en docs/chapter-patterns.md. El Agent lee este archivo de referencia cuando necesita identificar los límites de los capítulos, y lo ignora el resto del tiempo. Mantener el material de referencia en docs/ tiene dos ventajas: mantiene SKILL.md centrado en la lógica del flujo de trabajo y te permite actualizar los patrones sin tocar las instrucciones principales.

Por qué esta skill necesita una plantilla

El formato de salida es fijo: cada conjunto de notas de lectura sigue la misma estructura —resumen del libro, resúmenes de capítulos con puntos clave y citas, aspectos destacados de todo el libro y una sección de reflexión personal—. En lugar de reespecificar este formato en cada prompt, la skill lo guarda en templates/note-template.md. Cuando se ejecuta el Paso 5 (montaje final), el Agent carga la plantilla y rellena los marcadores. El formato es coherente cada vez y solo tienes que mantenerlo en un único lugar.

Cómo el SKILL.md referencia los archivos de apoyo

Las instrucciones de SKILL.md apuntan a cada archivo de apoyo de forma explícita:

### Paso 1: Analiza la estructura del libro

Ejecuta el script de preprocesamiento para obtener información del libro:
  python3 scripts/analyze-book.py <ruta-del-archivo> info

### Paso 5: Monta las notas

Genera la salida usando la plantilla: templates/note-template.md

Para los patrones de reconocimiento de encabezados de capítulo, consulta: docs/chapter-patterns.md

Escribir skills efectivas

Escribe “cuándo usarme”, no “qué hago”

Suenan parecido, pero tienen un impacto significativo en la precisión de la activación.

# Mal — describe la capacidad, no la condición de activación
description: This skill helps improve writing quality and checks chapters for common issues.

# Bien — describe cuándo activar
description: Use when reviewing a completed chapter draft for pacing, voice, and consistency issues.

Las descripciones permanecen en el contexto en todo momento: cada skill habilitada consume continuamente tu presupuesto de tokens. Que sean cortas, específicas, y expresa el escenario de activación directamente:

# Ineficiente (~45 tokens)
description: |
  This skill helps you review and improve your writing chapters.
  It checks for common issues like pacing problems, character voice...
  Use this when you want to ensure your chapter quality before proceeding.

# Eficiente (~9 tokens)
description: Use when reviewing a chapter for quality issues.

Pasos, entradas, salidas y condiciones de parada completos

Una instrucción de skill que solo escribe el comienzo de un proceso —sin una señal clara de finalización— deja que el Agent decida cuándo parar. Rara vez es donde tú quieres que pare. Cada paso debería tener:

Entrada: qué contexto o archivos necesita este paso
Salida: qué produce este paso
Condición de parada: cuándo esperar confirmación, cuándo continuar

Mantén el cuerpo ligero — traslada el material voluminoso a archivos de apoyo

Mantén SKILL.md por debajo de 5000 palabras. Si necesitas material de referencia grande —guías de estilo, patrones de reconocimiento, fichas de personaje—, ponlo en el subdirectorio docs/ y referéncialo por nombre de archivo. El Agent lo carga solo cuando lo necesita, y lo mantiene fuera del contexto el resto del tiempo.

Decide la activación automática según la frecuencia de uso

Frecuencia	Estrategia recomendada
Alta (más de una vez por sesión)	Deja la activación automática; refina la descripción para una activación más precisa
Baja (como mucho una vez por sesión)	Desactiva la activación automática; invócala manualmente; la descripción puede quedar fuera del contexto
Muy baja (menos de una vez al mes)	Elimina la skill; documéntala en SOLOENT.md en su lugar

Errores comunes

Problema	Síntoma	Cómo corregirlo
Descripción demasiado amplia	`description: help with writing` — cualquier petición de escritura la activa	Redúcela a un escenario específico; incluye frases de activación reales
Cuerpo demasiado largo	Cientos de líneas de manual metidas en el cuerpo de `SKILL.md`	Traslada el material de referencia a `docs/`; deja solo el esqueleto en las instrucciones
Una skill que hace cinco cosas	La misma skill cubre redacción, esquemas, revisión, diseño de personajes y diagnóstico	Divídelas; un dominio por skill, cada una activable de forma independiente

Resolución de problemas

Una skill no se activa cuando lo espero

Causa más probable: la descripción no es lo bastante específica, o la skill está desactivada.

Comprueba que la skill esté activada en el panel Skills
Reescribe la description para incluir las frases exactas y los tipos de tarea que usas — “ayuda con la escritura” rara vez activa correctamente; nombra el flujo de trabajo, la salida y frases de invocación de ejemplo
Asegúrate de que el directorio de la skill contenga un SKILL.md válido con los campos de frontmatter name y description
Verifica que name en el frontmatter coincida exactamente con el nombre del directorio

Una skill se activa cuando no quiero

La descripción es demasiado amplia — coincide con peticiones para las que no la pensaste.

Reduce la description para describir solo las tareas específicas que maneja esta skill
Desactiva la skill cuando trabajes fuera de su dominio
Si tienes varias skills con descripciones que se solapan, haz cada una más específica sobre cuándo debe y no debe activarse

Las instrucciones de la skill se ignoran o se siguen solo en parte

Comprueba estos problemas comunes:

Las instrucciones pueden superar el límite de contexto — mantén SKILL.md por debajo de 5000 palabras y traslada el material de referencia a subdirectorios docs/
Una regla global o del proyecto en conflicto puede estar anulando parte del comportamiento de la skill — revisa tus reglas activas en busca de contradicciones
Si la skill usa listas de comprobación, asegúrate de que cada elemento tenga una barrera explícita de “espera confirmación”; sin ella, el Agent puede avanzar automáticamente
Los archivos de apoyo referenciados en las instrucciones deben existir en las rutas especificadas — un archivo que falta hace que ese paso se salte en silencio

Los archivos de apoyo (plantillas, docs, scripts) no se cargan

El Agent solo carga los archivos de apoyo cuando las instrucciones los referencian explícitamente.

Comprueba que la ruta del archivo en la instrucción coincida con la ubicación real (p. ej., templates/chapter-outline.md, no solo chapter-outline.md)
Verifica que el archivo exista dentro del directorio de la skill en el subdirectorio correcto (templates/, docs/ o scripts/)
Si el archivo nunca se referencia por nombre en SKILL.md, el Agent no tiene motivo para cargarlo

Una skill del proyecto y una global con el mismo nombre entran en conflicto

Las skills del proyecto siempre tienen prioridad sobre las globales del mismo nombre.

Esto es el comportamiento esperado — si una skill del proyecto está activa, la global con el mismo nombre se ignora por completo
Si quieres que se aplique la global, renombra o elimina la del proyecto
Si ambas deben coexistir, dales nombres distintos y actualiza sus descripciones en consecuencia

Más consejos avanzados

Workflows

Automatiza procesos repetibles de varios pasos con archivos de workflow

Rules

Captura tus preferencias de escritura para que el Agent escriba siempre con tu voz

Rules vs. Workflows vs. Skills

Tres formas de dar instrucciones a tu Agent — conoce las diferencias y cuándo usar cada una

Introducción

Inicio rápido

Escritura flexible

Escritura de alta calidad

Suscripción y pago

Recursos gratuitos

Solución de problemas

Cómo funcionan las skills

Dónde viven las skills

Activar y desactivar skills

Crear una skill

Tres tipos comunes de skill

Tipo 1: de lista de comprobación

Tipo 2: de flujo de trabajo

Tipo 3: experto de dominio

Ejemplo completo: resumen de un libro

Estructura de directorios

Por qué esta skill necesita un script

Por qué esta skill necesita un archivo docs

Por qué esta skill necesita una plantilla

Cómo el SKILL.md referencia los archivos de apoyo

Escribir skills efectivas

Escribe “cuándo usarme”, no “qué hago”

Pasos, entradas, salidas y condiciones de parada completos

Mantén el cuerpo ligero — traslada el material voluminoso a archivos de apoyo

Decide la activación automática según la frecuencia de uso

Errores comunes

Resolución de problemas

Más consejos avanzados

Workflows

Rules

Rules vs. Workflows vs. Skills

​Cómo funcionan las skills

​Dónde viven las skills

​Activar y desactivar skills

​Crear una skill

​Tres tipos comunes de skill

​Tipo 1: de lista de comprobación

​Tipo 2: de flujo de trabajo

​Tipo 3: experto de dominio

​Ejemplo completo: resumen de un libro

​Estructura de directorios

​Por qué esta skill necesita un script

​Por qué esta skill necesita un archivo docs

​Por qué esta skill necesita una plantilla

​Cómo el SKILL.md referencia los archivos de apoyo

​Escribir skills efectivas

​Escribe “cuándo usarme”, no “qué hago”

​Pasos, entradas, salidas y condiciones de parada completos

​Mantén el cuerpo ligero — traslada el material voluminoso a archivos de apoyo

​Decide la activación automática según la frecuencia de uso

​Errores comunes

​Resolución de problemas

​Más consejos avanzados

Workflows

Rules

Rules vs. Workflows vs. Skills

Cómo funcionan las skills

Dónde viven las skills

Activar y desactivar skills

Crear una skill

Tres tipos comunes de skill

Tipo 1: de lista de comprobación

Tipo 2: de flujo de trabajo

Tipo 3: experto de dominio

Ejemplo completo: resumen de un libro

Estructura de directorios

Por qué esta skill necesita un script

Por qué esta skill necesita un archivo docs

Por qué esta skill necesita una plantilla

Cómo el SKILL.md referencia los archivos de apoyo

Escribir skills efectivas

Escribe “cuándo usarme”, no “qué hago”

Pasos, entradas, salidas y condiciones de parada completos

Mantén el cuerpo ligero — traslada el material voluminoso a archivos de apoyo

Decide la activación automática según la frecuencia de uso

Errores comunes

Resolución de problemas

Más consejos avanzados