Skill oficial · Éxito del cliente

Artículo del centro de ayuda

v1.0.0 · Actualizada el 4 de noviembre de 2026

Escribe un artículo del centro de ayuda para una tarea: título por la tarea, respuesta primero, pasos numerados con las etiquetas exactas, notas de capturas, solución de problemas y enlaces.

Funciona en Claude, ChatGPT y agentes de programación. En Team y Business, la skill oficial de tu pod se actualiza sola cuando la mejoramos.

Cuándo usarla

• Una pregunta se repite y la respuesta solo está en las respuestas de los agentes
• Salió una función nueva y los clientes necesitan una guía paso a paso

Qué le das

• La tarea y quién puede hacerla
• Los pasos reales y las etiquetas de la interfaz
• Problemas conocidos de los tickets

Qué obtienes

Un artículo de ayuda listo para publicar, con marcadores de capturas de pantalla y una sección de solución de problemas.

Cómo funciona

1. Titúlalo por la tarea Empieza con un verbo en la forma en que los clientes buscan: “Exportar tus contactos a CSV”, “Agregar a un compañero a tu espacio de trabajo”. No “Función de exportación” ni “Cómo funcionan las exportaciones”. Una tarea por artículo; si las notas cubren 2 tareas, escribe 2 artículos.
2. Responde en las 2 primeras frases Di qué hace la tarea y el camino más corto: “Puedes exportar los contactos desde **Contactos > Exportar**. El archivo llega por correo en unos minutos”. Después, quién puede hacerlo y qué necesita antes (rol, plan, permiso).
3. Escribe pasos numerados, una acción por paso Empieza cada paso con el verbo. Pon las etiquetas de la interfaz en negrita, exactamente como aparecen, mayúsculas incluidas. Escribe las rutas de menú como **Configuración** > **Equipo**, con las flechas sin negrita. Indica el lugar antes de la acción: “En la esquina superior derecha, haz clic en **Configuración**”. Quédate entre 3 y 10 pasos; si son más, divídelos en secciones con su propio encabezado.
4. Di cómo se ve el éxito Después del último paso, una línea sobre lo que el cliente debería ver si funcionó: un mensaje, un archivo, un elemento nuevo en una lista.
5. Marca capturas de pantalla donde ayuden Agrega un marcador después de un paso cuyo objetivo cueste encontrar o cuya pantalla esté muy cargada, no después de cada paso. Escribe qué muestra la captura, para que se pueda hacer después y sirva como texto alternativo.
6. Agrega la solución de problemas a partir de problemas reales Cada punto es el síntoma en palabras del cliente como encabezado y, debajo, la causa y la solución en 1 a 3 frases. Usa solo problemas de los tickets o del equipo de producto; no inventes errores.
7. Enlaza de 2 a 4 artículos relacionados La siguiente tarea que probablemente hará y el requisito previo. Usa los títulos reales de los artículos si te los dan; si no, escribe “[relacionado: tema]”.

El SKILL.md

El archivo completo, tal como lo lee tu IA. Descargarlo

---
name: help-article-writer
description: Escribe un artículo del centro de ayuda o de la base de conocimiento para una tarea del cliente, titulado por la tarea, con la respuesta primero, pasos numerados con las etiquetas exactas de la interfaz, marcadores para capturas de pantalla, una sección de solución de problemas y artículos relacionados. Úsala cuando alguien pide un artículo de ayuda, un documento de soporte, una guía paso a paso (how-to), una página de la base de conocimiento, o convertir la respuesta a un ticket, una nota de versión o unas notas sueltas en un artículo que los clientes puedan seguir solos.
---

# Redactor de artículos de ayuda

Un artículo de ayuda permite a un cliente terminar una tarea sin contactar a soporte. Llega desde el buscador, busca su tarea con la vista y sigue los pasos con el producto abierto al lado del artículo. Titúlalo por la tarea, pon la respuesta primero y haz que cada paso sea una sola acción, con la etiqueta exactamente como aparece en pantalla.

## Cuándo usarla

- Una pregunta se repite en los tickets y la respuesta solo está en las respuestas de los agentes.
- Salió una función nueva y los clientes necesitan saber cómo usarla.
- Un artículo existente es largo, está desactualizado o usa palabras internas.
- No sirve para una lista de preguntas frecuentes con muchas preguntas: usa faq-from-tickets. Tampoco para notas de versión: usa release-notes.

## Qué necesitas

- La tarea que cubre el artículo y quién la hace (cualquier usuario, solo administradores, un plan concreto).
- Los pasos reales: las pantallas, los botones y los nombres de los menús tal como los muestra el producto. Si solo tienes una descripción, escribe los pasos y marca cada etiqueta dudosa con “[comprobar etiqueta]”.
- Los problemas conocidos: errores con los que se encuentran los clientes, sacados de los tickets o del equipo de producto.
- Opcional: artículos existentes para enlazar como relacionados.

## Pasos

1. **Titúlalo por la tarea.** Empieza con un verbo en la forma en que los clientes buscan: “Exportar tus contactos a CSV”, “Agregar a un compañero a tu espacio de trabajo”. No “Función de exportación” ni “Cómo funcionan las exportaciones”. Una tarea por artículo; si las notas cubren 2 tareas, escribe 2 artículos.
2. **Responde en las 2 primeras frases.** Di qué hace la tarea y el camino más corto: “Puedes exportar los contactos desde **Contactos > Exportar**. El archivo llega por correo en unos minutos”. Después, quién puede hacerlo y qué necesita antes (rol, plan, permiso).
3. **Escribe pasos numerados, una acción por paso.** Empieza cada paso con el verbo. Pon las etiquetas de la interfaz en negrita, exactamente como aparecen, mayúsculas incluidas. Escribe las rutas de menú como **Configuración** > **Equipo**, con las flechas sin negrita. Indica el lugar antes de la acción: “En la esquina superior derecha, haz clic en **Configuración**”. Quédate entre 3 y 10 pasos; si son más, divídelos en secciones con su propio encabezado.
4. **Di cómo se ve el éxito.** Después del último paso, una línea sobre lo que el cliente debería ver si funcionó: un mensaje, un archivo, un elemento nuevo en una lista.
5. **Marca capturas de pantalla donde ayuden.** Agrega un marcador después de un paso cuyo objetivo cueste encontrar o cuya pantalla esté muy cargada, no después de cada paso. Escribe qué muestra la captura, para que se pueda hacer después y sirva como texto alternativo.
6. **Agrega la solución de problemas a partir de problemas reales.** Cada punto es el síntoma en palabras del cliente como encabezado y, debajo, la causa y la solución en 1 a 3 frases. Usa solo problemas de los tickets o del equipo de producto; no inventes errores.
7. **Enlaza de 2 a 4 artículos relacionados.** La siguiente tarea que probablemente hará y el requisito previo. Usa los títulos reales de los artículos si te los dan; si no, escribe “[relacionado: tema]”.

## Formato de salida

```markdown
# [Título de la tarea, empezando por el verbo]

[Qué hace y el camino más corto, 1–2 frases.]

**Quién puede hacerlo:** [rol / plan] · **Antes de empezar:** [requisito previo, o quítalo]

## [Tarea, o primera parte de la tarea]
1. [Lugar], haz clic en **[Etiqueta]**.
2. [...]

![Captura de pantalla: lo que muestra]

Si funcionó, [lo que ve el cliente].

## Solución de problemas
### [Síntoma en palabras del cliente]
[Causa y solución, 1–3 frases.]

## Artículos relacionados
- [Título del artículo]
```

## Ejemplo

**Entrada:**

> Notas de producto: los administradores pueden invitar a compañeros desde Configuración → Equipo → botón “Invitar personas”, escribir correos (separados por comas), elegir el rol Miembro o Lector y luego Enviar invitaciones. La invitación caduca a los 7 días. Tickets: la gente dice que el correo de invitación nunca llegó (normalmente está en spam, o el correo era incorrecto); “Invitar personas” aparece en gris para quien no es administrador.

**Salida:**

```markdown
# Invitar a un compañero a tu espacio de trabajo

Puedes invitar a compañeros desde **Configuración** > **Equipo** > **Invitar personas**. Reciben un correo con un enlace para unirse; el enlace funciona durante 7 días.

**Quién puede hacerlo:** los administradores del espacio de trabajo

## Enviar una invitación
1. En el menú de la izquierda, haz clic en **Configuración**.
2. Haz clic en **Equipo**.
3. Haz clic en **Invitar personas**.
4. Escribe una o más direcciones de correo, separadas por comas.
5. Elige un rol: **Miembro** o **Lector**.
6. Haz clic en **Enviar invitaciones**.

![Captura de pantalla: la ventana Invitar personas con dos correos escritos y el menú de roles abierto]

Si funcionó, cada persona aparece en la lista de Equipo como “Invitado” hasta que se une.

## Solución de problemas
### El correo de invitación nunca llegó
Pídele que revise su carpeta de spam o de correo no deseado. Si no está ahí, comprueba la dirección en la lista de Equipo y vuelve a enviar la invitación.

### Invitar personas aparece en gris
Solo los administradores pueden invitar. Pide a un administrador del espacio de trabajo que invite a esa persona o que te haga administrador.

## Artículos relacionados
- [relacionado: cambiar el rol de un compañero]
- [relacionado: quitar a un compañero]
```

## Comprobaciones antes de enviar

- [ ] El título empieza con un verbo y nombra una sola tarea.
- [ ] Las 2 primeras frases responden la pregunta sin los pasos.
- [ ] Cada paso tiene una sola acción, y cada etiqueta de la interfaz está en negrita y coincide con el producto o está marcada con “[comprobar etiqueta]”.
- [ ] El artículo dice quién puede hacerlo y cómo se ve el éxito.
- [ ] Cada punto de la solución de problemas viene de los tickets o del equipo de producto.
- [ ] No aparecen palabras internas (ticket, SKU, feature flag, backend).

## Errores comunes

- Empezar con contexto (“Los equipos son una parte importante de…”). El lector vino por los pasos.
- Escribir “Ve a la página de configuración y configura tu equipo”. Nombra cada clic.
- Una captura de pantalla después de cada paso. Alarga la página y queda desactualizada con cada cambio de la interfaz.

Compártela con tu equipo

Agrégala a un AI Skill Pod y todo el equipo, colaboradores externos incluidos, usa la misma versión desde su propia IA. Lee las mejores formas de compartir skills de IA con un equipo

Agregar al pod de mi equipo

Historial de cambios

• v1.0.0 · 4 de noviembre de 2026 · First release.