# Inicio rápido de Skills

Elige la ruta de Skill independiente cuando el host del agente no pueda montar directamente un servidor MCP alojado.

- Canonical: https://docs.xmemo.dev/es/docs/skills/quickstart
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 6ba591b56f318400d8b7be59a77c62166fdb9bfcc7a5682e373a3d37a5b27f17
- Edition-Digest: a23a8845f45cd64ec159164061c04bcdc03584f3f9cfe778bb990e7d75d2f8c2
- Source-Revision: sha256:155eed78733b301c44438f3428593a7838254964821afe158cef180b6dcfda2f

## Cuándo elegir la Skill en lugar de MCP

La Skill independiente es un runtime conector de agentes para hosts que no pueden montar un servidor MCP alojado, comunicándose a través de HTTPS directo con XMemo. Es distinta de las Cloud Skills creadas por el usuario (SOP procedimentales reutilizables almacenados en XMemo).

- Usa MCP alojado cuando el host del agente monte de forma nativa servidores MCP remotos.
- Usa el runtime de la Skill independiente cuando el host ejecute herramientas CLI locales o scripts de skill en su lugar.
- Requisito de runtime: Node.js 22.22.0 o superior (Node.js >= 22.22.0) con soporte ESM integrado.
- Cero dependencias externas: El script de skill empaquetado utiliza únicamente módulos integrados estándar de Node.js.
- Comunicación HTTPS directa: Las solicitudes salientes se comunican directamente con https://xmemo.dev/v1/skill/operations.

## Instalación por prompt y por cliente

Instala la Skill independiente en el directorio de skills de tu agente. Puedes proporcionar el prompt de instalación oficial a tu agente, usar la CLI de XMemo o ejecutar directamente el instalador HTTPS canónico.

- Prompt para tu agente: Instala la Skill independiente de XMemo en tu directorio de skills: ejecuta el instalador desde https://xmemo.dev/skill/install (en Windows, https://xmemo.dev/skill/install.ps1) con XMEMO_SKILL_DIR configurado en tu directorio de skills más /xmemo-memory. Ejecuta el comando doctor que imprime para verificar la instalación, luego recarga tus skills y sigue los pasos iniciales de la Skill. Sigue tus comprobaciones de seguridad normales y no utilices privilegios elevados.
- Claude Code global: ~/.claude/skills/xmemo-memory (nivel de proyecto: .claude/skills/xmemo-memory).
- Codex: ~/.codex/skills/xmemo-memory (o ${CODEX_HOME:-$HOME/.codex}/skills/xmemo-memory).
- OpenClaw: ~/.openclaw/skills/xmemo-memory o instalar a través de ClawHub (https://clawhub.ai/xmemo/skills/xmemo).
- CLI de XMemo: xmemo skill install --client <id> (compatible con claude-code, codex y openclaw) o xmemo skill install --all.
- Instalador manual de respaldo: POSIX 'curl -fsSL https://xmemo.dev/skill/install | sh' o PowerShell 'irm https://xmemo.dev/skill/install.ps1 | iex'.
- Aviso de lanzamiento del servicio: La creación automatizada del directorio principal y la línea de doctor posterior a la instalación surten efecto tras el próximo lanzamiento del servicio; en entornos de versiones preliminares, asegúrate de que el directorio principal exista antes de ejecutar el instalador.

```bash
# Ask your agent to run the installer, or run it directly:
curl -fsSL https://xmemo.dev/skill/install | XMEMO_SKILL_DIR="$HOME/.claude/skills/xmemo-memory" sh

# Or install via XMemo CLI:
xmemo skill install --client claude-code
```

## Primera ejecución y autenticación

Ejecuta comprobaciones de conectividad y autenticación desde el directorio de la skill instalada antes de iniciar operaciones de memoria. La instalación, la autenticación y la activación son hitos distintos.

- Comprobar accesibilidad: Ejecuta doctor --anonymous para verificar la accesibilidad de la red y del servicio sin credenciales.
- Elegir fuente de credenciales: Prefiere una XMEMO_KEY suministrada por un almacén de secretos administrado (Doppler, 1Password o entorno).
- Inicio de sesión interactivo: Ejecuta login --allow-plaintext para iniciar el inicio de sesión del dispositivo basado en navegador. El indicador --allow-plaintext confirma explícitamente almacenar el token sin cifrar en ~/.xmemo/skill-credentials.json con permisos POSIX 0600.
- Verificar autenticación: Ejecuta auth status --verify para validar que tu credencial posea los scopes de memoria requeridos.

```bash
node scripts/xmemo-skill.mjs doctor --anonymous
node scripts/xmemo-skill.mjs login --allow-plaintext
node scripts/xmemo-skill.mjs auth status --verify
```

## Primera tarea útil de memoria

Completa un ciclo de vida de memoria completo: guarda un hecho sintético del proyecto, recupéralo con atribución de origen, actualízalo cuando cambien los detalles y, opcionalmente, elimínalo mediante soft-delete tras confirmación.

- 1. Guardar hecho sintético: node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions".
- 2. Recuperar hecho: node scripts/xmemo-skill.mjs recall --query "project timestamp convention". Comprueba que la memoria devuelta coincida con tu contenido guardado.
- 3. Actualizar memoria: node scripts/xmemo-skill.mjs update --id <id> --content "Project convention: all timestamps use UTC with ISO 8601 formatting.".
- 4. Limpieza opcional: node scripts/xmemo-skill.mjs forget --id <id> --confirm. La eliminación requiere estrictamente --confirm.

```bash
node scripts/xmemo-skill.mjs remember --content "Project convention: all timestamps use UTC." --path "projects/onboarding/conventions"
node scripts/xmemo-skill.mjs recall --query "project timestamp convention"
node scripts/xmemo-skill.mjs update --id mem_01hxyz... --content "Project convention: all timestamps use UTC with ISO 8601 formatting."
node scripts/xmemo-skill.mjs forget --id mem_01hxyz... --confirm
```

## Perfil del proyecto y oferta de AGENTS.md

Cuando se completa el inicio de sesión de la primera ejecución, el agente puede ofrecer añadir una sección de memoria de XMemo al archivo AGENTS.md de tu proyecto. Esta oferta requiere el consentimiento explícito del usuario por separado.

- Oferta con consentimiento independiente: Si el proyecto carece de una sección de XMemo, el agente pregunta una vez: 'Want XMemo used automatically in every session of this project? I can add a short XMemo section to AGENTS.md (yes / later / don't ask again).'
- Imprimir instrucciones: node scripts/xmemo-skill.mjs profile imprime las instrucciones de prompt recomendadas para la configuración del agente del proyecto.
- Registrar preferencia del usuario: node scripts/xmemo-skill.mjs profile --status later o node scripts/xmemo-skill.mjs profile --status never registra la respuesta para que el agente no pregunte repetidamente.
- Registros del ecosistema: El registro verificado de la Skill está disponible en ClawHub en https://clawhub.ai/xmemo/skills/xmemo; plugin complementario de OpenClaw en https://clawhub.ai/xmemo/plugins/openclaw-memory.

```bash
# Inspect agent profile instructions:
node scripts/xmemo-skill.mjs profile

# Record deferred or declined offer:
node scripts/xmemo-skill.mjs profile --status later
node scripts/xmemo-skill.mjs profile --status never
```