Saltar al contenido principal
Las habilidades son archivos Markdown que dan al Agente un conocimiento profundo y específico para un tipo de trabajo determinado. Define una para la creación de relatos cortos, otra para el análisis de libros, otra para el formato de guiones — y el Agente carga solo la habilidad relevante para lo que estás haciendo ahora.

​
Cómo funcionan las habilidades

Las habilidades usan carga progresiva para mantener el contexto ligero. Al abrir un proyecto, el Agente solo ve los nombres y descripciones de todas las habilidades — unas pocas decenas de palabras cada una. Eso es todo lo que se carga al iniciar. Cuando tu solicitud coincide con la descripción de una habilidad, el Agente la activa y carga sus instrucciones completas. Una habilidad de creación de relatos cortos permanece inactiva mientras escribes una carta de presentación. Una habilidad de ficción de terror no consume contexto cuando estás esbozando un thriller.
NivelCuándo se cargaContenido
MetadatosSiempre, al iniciarNombre y descripción del frontmatter
InstruccionesCuando se activa la habilidadCuerpo completo de SKILL.md
Archivos de apoyoSegún se necesitenPlantillas, scripts, documentos de referencia

​
Estructura y ubicación de las habilidades

Cada habilidad es un directorio que contiene un archivo SKILL.md. El nombre del directorio se convierte en el nombre de la habilidad. Las habilidades también pueden incluir archivos de apoyo en tres subdirectorios opcionales. 
your-novel/
├── .soloent/
│   └── skills/                  # Habilidades del workspace (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 Agente puede ejecutar
│               └── word-count.py
├── SOLOENT.md
├── chapters/
└── ...
Los archivos de apoyo solo se cargan cuando las instrucciones los referencian — no consumen contexto al iniciar. Una plantilla permanece inactiva hasta que el Agente llega al paso que la requiere. Un documento de referencia solo se lee cuando el Agente necesita consultarlo. Las habilidades globales se almacenan en el directorio de habilidades del sistema y están disponibles en todos tus proyectos. Úsalas para capacidades de uso general que aplicas de forma consistente — una habilidad para generar frases de apertura, o una que guíe al Agente a través de tu proceso estándar de revisión de manuscritos. Las habilidades del workspace se encuentran en .soloent/skills/ en la raíz de tu proyecto. Úsalas para capacidades vinculadas a un proyecto o género específico — una habilidad construida alrededor de las reglas particulares de tu serie de romance, o una calibrada según el nivel explícito y el registro narrativo de tu historia actual.
Cuando una habilidad global y una del workspace comparten el mismo nombre, la del workspace tiene prioridad.

​
Activar y desactivar habilidades

Cada habilidad tiene un interruptor para activarla o desactivarla sin borrar el archivo. Desactiva una habilidad cuando no la necesites para la tarea actual — esto la saca del contexto y evita activaciones no deseadas.

​
Crear una habilidad

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 habilidad, no qué hace.
---

Instrucciones que el Agente debe seguir cuando se activa esta habilidad.
Dos campos de frontmatter obligatorios:
  • name debe coincidir exactamente con el nombre del directorio
  • description describe cuándo activar esta habilidad, no qué hace (menos de 1.024 caracteres)
Archivo SKILL.md abierto en el editor mostrando los campos name y description, con el panel Skills a la derecha mostrando la habilidad english-short-story listada bajo Habilidades del workspace
1

Abrir el menú de Skills

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

Crear una nueva habilidad

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

Escribir las instrucciones de la habilidad

Edita el archivo SKILL.md:
  • Actualiza description para especificar cuándo debe activarse esta habilidad
  • Añade tus instrucciones, listas de verificació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 habilidad english-short-story — una habilidad de tipo experto en dominio con un flujo de trabajo completo de 6 pasos, listas de verificación y condiciones de parada. Puedes copiarlo y usarlo directamente.
---
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 de habilidades habituales

​
Tipo 1: Lista de verificación

Ideal para verificar múltiples criterios en un punto fijo — para que nada se escape. Por ejemplo, una verificación antes de entregar cada capítulo: 
---
name: chapter-submission-check
description: Use before finalizing a chapter to verify word count, consistency, and all checklist items.
---

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

## Salida
Aprobado / No aprobado por elemento. Cualquier elemento no aprobado debe corregirse antes de continuar.

​
Tipo 2: Flujo de trabajo

Ideal para operaciones con un orden de pasos definido y confirmación antes de ejecutar. 
---
name: chapter-rewrite
description: Rewrite a chapter from scratch. Run only when explicitly requested.
---

## Pasos
1. Copia de seguridad: guardar el capítulo actual como ch-XX-original.md para preservar el original
2. Explicación: resumir en un párrafo la dirección principal de esta reescritura y esperar confirmación del usuario antes de escribir
3. Ejecución: escribir el capítulo completo en la nueva dirección (900–1.200 palabras)
4. Verificación: ejecutar la lista de verificación del capítulo contra el original y mostrar las principales diferencias entre la versión nueva y la antigua

​
Tipo 3: Experto en dominio

Ideal cuando quieres que el Agente trabaje desde la experiencia experta en lugar de adivinar. Por ejemplo, una habilidad 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.
---

## Recopilación de evidencia
1. Leer el texto completo del capítulo problemático
2. Comparar con el plan de beats del capítulo en la sección 4 de SOLOENT.md
3. Verificar la curva emocional de los capítulos anterior y posterior

## Matriz de decisión
| Síntoma | Verificar primero |
|---|---|
| El ritmo se arrastra | Densidad de beats / párrafos sin efecto |
| Emoción plana | Consistencia de voz del personaje / demasiado monólogo interno |
| Gancho final falla | Tipo de tensión / 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 libro

Esta es una habilidad de tipo experto en 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 una habilidad de tipo experto en dominio. Esta habilidad extrae notas de lectura estructuradas de un archivo de libro local — resúmenes de capítulos, ideas clave y citas — y los guarda como Markdown formateado.

​
Estructura de directorios

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

​
Por qué esta habilidad necesita un script

Los libros son largos. Cargar toda una novela en el contexto para extraer su estructura de capítulos sería un desperdicio y lento. El script de preprocesamiento resuelve esto:
  • Comando info — lee las primeras 50 líneas para identificar el título, la codificación y el recuento 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 específico, para que el Agente procese un capítulo a la vez
El Agente 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 habilidad necesita un archivo docs

Los formatos de encabezados de capítulo varían mucho entre libros chinos e ingleses. En lugar de incluir todos los patrones de reconocimiento en SKILL.md, la habilidad los almacena en docs/chapter-patterns.md. El Agente lee este archivo de referencia cuando necesita identificar límites de capítulos — y lo ignora en caso contrario. Mantener el material de referencia en docs/ tiene dos ventajas: mantiene SKILL.md enfocado en la lógica del flujo de trabajo, y permite actualizar los patrones sin tocar las instrucciones principales.

​
Por qué esta habilidad 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 re-especificar este formato en cada prompt, la habilidad lo almacena en templates/note-template.md. Cuando se ejecuta el Paso 5 (ensamblaje final), el Agente carga la plantilla y rellena los marcadores de posición. El formato es consistente cada vez, y solo necesitas mantenerlo en un lugar.

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

Las instrucciones en SKILL.md apuntan explícitamente a cada archivo de apoyo: 
### Paso 1: Analizar la estructura del libro

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

### Paso 5: Ensamblar las notas

Generar usando la plantilla: templates/note-template.md

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

​
Escribir habilidades eficaces

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

Suenan parecido, pero tienen un impacto significativo en la precisión del disparo. 
# Incorrecto — describe la capacidad, no la condición de disparo
description: This skill helps improve writing quality and checks chapters for common issues.

# Correcto — describe cuándo activarse
description: Use when reviewing a completed chapter draft for pacing, voice, and consistency issues.
Las descripciones permanecen en el contexto en todo momento — cada habilidad habilitada consume continuamente tu presupuesto de tokens. Mantenlas cortas, específicas, y describe directamente el escenario de disparo: 
# 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 completos, entradas, salidas y condiciones de parada

Una instrucción de habilidad que solo escribe el comienzo de un proceso — sin señal clara de finalización — deja al Agente decidir cuándo parar. Eso rara vez es donde quieres que pare. Cada paso debe 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 liviano — mueve el material voluminoso a archivos de apoyo

Mantén SKILL.md por debajo de 5.000 palabras. Si necesitas material de referencia extenso — guías de estilo, patrones de reconocimiento, perfiles de personajes — ponlos en el subdirectorio docs/ y referencialos por nombre de archivo. El Agente los carga solo cuando los necesita, manteniéndolos fuera del contexto en caso contrario.

​
Decide el disparo automático según la frecuencia de uso

FrecuenciaEstrategia recomendada
Alta (más de una vez por sesión)Mantener el disparo automático; refinar la descripción para una activación más precisa
Baja (como máximo una vez por sesión)Desactivar el disparo automático; invocar manualmente; la descripción puede estar fuera del contexto
Muy baja (menos de una vez al mes)Eliminar la habilidad; documentarla en SOLOENT.md en su lugar

​
Errores comunes

ProblemaSíntomaSolución
Descripción demasiado ampliadescription: help with writing — cualquier solicitud de escritura la activaReducir a un escenario específico; incluir frases de disparo reales
Cuerpo demasiado largoCientos de líneas de manual de trabajo metidas en SKILL.mdMover el material de referencia a docs/; mantener solo el esqueleto en las instrucciones
Una habilidad haciendo cinco cosasLa misma habilidad cubre revisión, continuación, esquema, diseño de personajes y diagnósticoSepararlas; un dominio por habilidad, cada una con su propio interruptor

​
Usar habilidades de otros

No necesitas escribir cada habilidad desde cero. Las habilidades son directorios autosuficientes — puedes instalarlas manualmente, clonarlas desde un repositorio, o instalarlas como plugin.

​
Instalación manual

Descarga o copia un directorio de habilidad y colócalo en el lugar correcto:
  • Habilidades globales → el directorio de habilidades del sistema (disponible en todos los proyectos)
  • Habilidades del workspace → .soloent/skills/ dentro de tu proyecto
La habilidad se activa inmediatamente una vez que SoloEnt detecta el directorio. No se requiere reinicio. 
your-novel/
├── .soloent/
│   └── skills/
│       └── book-summary/      ← coloca un directorio de habilidad aquí
│           ├── SKILL.md
│           ├── templates/
│           ├── docs/
│           └── scripts/

​
Mediante git clone

Las habilidades públicas alojadas en GitHub se pueden clonar directamente en tu directorio de habilidades: 
cd your-novel/.soloent/skills/
git clone https://github.com/author/skill-name
Esto también facilita mantener la habilidad actualizada — obtén cambios del repositorio en cualquier momento con git pull.
Si quieres que una habilidad esté disponible en todos tus proyectos, clónala en tu directorio de habilidades global en lugar de un directorio del workspace.

​
Mediante plugin

Algunos autores de habilidades las distribuyen como un archivo de extensión .vsix empaquetado. Instalar la extensión carga las habilidades incluidas automáticamente — no se necesita colocar archivos manualmente.
1

Obtener el archivo .vsix

Descarga el archivo .vsix del repositorio o canal de distribución del autor de la habilidad.
2

Instalar la extensión

En SoloEnt, abre el panel de Extensiones, haz clic en el menú ··· y selecciona Instalar desde VSIX…. Elige el archivo descargado.
3

Confirmar que las habilidades están cargadas

Abre el panel de Skills. Las habilidades incluidas en la extensión aparecen en tu lista de habilidades y están listas para usar.
Revisa el SKILL.md de una habilidad antes de activarla. Las habilidades se ejecutan con tus permisos y pueden leer y modificar los archivos de tu proyecto.

​
Solución de problemas

Causa más probable: La descripción no es suficientemente específica, o la habilidad está desactivada.
  • Comprueba que la habilidad está activada en el panel de Skills
  • Reescribe description para incluir las frases exactas y tipos de tareas que usas — “ayuda con la escritura” rara vez dispara correctamente; nombra el flujo de trabajo, la salida y frases de invocación de ejemplo
  • Asegúrate de que el directorio de la habilidad contiene un SKILL.md válido con los campos frontmatter name y description
  • Verifica que name en el frontmatter coincida exactamente con el nombre del directorio
La descripción es demasiado amplia — coincide con solicitudes para las que no estaba prevista.
  • Reduce description para describir solo las tareas específicas que maneja esta habilidad
  • Desactiva la habilidad cuando estés trabajando fuera de su dominio
  • Si tienes múltiples habilidades con descripciones que se solapan, haz cada una más específica sobre cuándo debe y no debe activarse
Comprueba estos problemas habituales:
  • Las instrucciones pueden superar el límite de contexto — mantén SKILL.md por debajo de 5.000 palabras y mueve el material de referencia a subdirectorios docs/
  • Una regla global o de proyecto en conflicto puede estar anulando parte del comportamiento de la habilidad — comprueba tus reglas activas para detectar contradicciones
  • Si la habilidad usa listas de verificación, asegúrate de que cada punto tiene una puerta explícita de “esperar confirmación”; sin ella el Agente puede avanzar automáticamente
  • Los archivos de apoyo referenciados en las instrucciones deben existir en las rutas especificadas — un archivo faltante hace que ese paso se omita silenciosamente
El Agente solo carga los archivos de apoyo cuando las instrucciones los referencian explícitamente.
  • Comprueba que la ruta del archivo en la instrucción coincide con la ubicación real (p. ej., templates/chapter-outline.md, no solo chapter-outline.md)
  • Verifica que el archivo existe dentro del directorio de la habilidad bajo el subdirectorio correcto (templates/, docs/, o scripts/)
  • Si el archivo nunca se referencia por nombre en SKILL.md, el Agente no tiene motivo para cargarlo
Las habilidades del workspace siempre tienen prioridad sobre las globales con el mismo nombre.
  • Este es el comportamiento esperado — si una habilidad del workspace está activa, la habilidad global con el mismo nombre se ignora por completo
  • Si quieres que se aplique la habilidad global, renombra o elimina la del workspace
  • Si ambas deben coexistir, dales nombres distintos y actualiza sus descripciones en consecuencia

​
Más consejos avanzados

Flujos de trabajo

Automatiza procesos repetitivos de múltiples pasos con archivos de flujo de trabajo

Reglas

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

Reglas vs. Flujos de trabajo vs. Habilidades

Tres formas de instruir a tu Agente — aprende las diferencias y cuándo usar cada una