> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar Skills

> Instala nuestros Skills cuidadosamente diseñados para que tu asistente de IA aproveche mejor Linkly AI y obtenga contexto de tus documentos locales, mejorando enormemente la eficiencia.

## Introducción a Skills

Agent Skills es un paquete de habilidades que sigue el estándar abierto de [agentskills.io](https://agentskills.io). Linkly AI Skills enseña a tu asistente de IA cómo conectarse y usar las herramientas de Linkly AI, permitiéndole buscar, explorar y leer tus documentos locales.

**¿Por qué necesitas Skills?**

Después de instalar Linkly AI Desktop, ya dispones de potentes capacidades de indexación y recuperación de documentos. Sin embargo, los asistentes de IA (como Claude Code, Codex) no saben cómo usar estas herramientas. Skills actúa como un "manual de uso" que permite al asistente de IA dominar automáticamente el método correcto, incluyendo:

* Cómo detectar y conectarse a Linkly AI
* Cuándo buscar, cuándo explorar el índice y cuándo leer el texto completo
* Cómo gestionar la lectura paginada de documentos largos
* Cómo tratar el contenido de los documentos de forma segura

## Instalar Skills

<Tabs>
  <Tab title="skills.sh (recomendado)" icon="bolt">
    Usa [skills.sh](https://skills.sh) para instalar en todos los asistentes de IA compatibles con un solo comando:

    ```bash theme={null}
    npx skills add LinklyAI/linkly-ai-skills
    ```

    O instala en un asistente de IA específico:

    ```bash theme={null}
    # Claude Code
    npx skills add LinklyAI/linkly-ai-skills -a claude-code

    # Codex CLI
    npx skills add LinklyAI/linkly-ai-skills -a codex
    ```
  </Tab>

  <Tab title="Claude Code" icon="terminal">
    Clona Skills en el directorio de skills de Claude Code:

    ```bash theme={null}
    # Nivel personal (disponible en todos los proyectos)
    git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai

    # Nivel de proyecto (solo disponible en el proyecto actual)
    git clone https://github.com/LinklyAI/linkly-ai-skills.git .claude/skills/linkly-ai
    ```
  </Tab>

  <Tab title="Codex CLI" icon="code">
    Clona Skills en el directorio de skills de Codex CLI:

    ```bash theme={null}
    git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.agents/skills/linkly-ai
    ```
  </Tab>

  <Tab title="Claude.ai (versión web)" icon="globe">
    <Steps>
      <Step title="Descargar el paquete Skills">
        Ve a la página de [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) y descarga el archivo `linkly-ai.zip` más reciente.
      </Step>

      <Step title="Subir a Claude.ai">
        En Claude.ai, abre Settings → Capabilities → Skills y sube el archivo zip descargado.
      </Step>
    </Steps>
  </Tab>
</Tabs>

También puedes instalarlo en OpenClaw a través de [ClawHub](https://openclaw.org):

```bash theme={null}
clawhub install linkly-ai
```

## Usar Skills

Tras instalar Skills, **no necesitas aprender ningún comando especial**. Solo haz preguntas en lenguaje natural a tu asistente de IA; Skills reconocerá automáticamente tu intención y activará las operaciones correspondientes.

### Activación automática

El asistente de IA determinará automáticamente si necesita usar las herramientas de Linkly AI según las palabras clave de tu solicitud. Por ejemplo:

<CardGroup cols={1}>
  <Card title="Búsqueda" icon="magnifying-glass" iconType="duotone" horizontal>
    "Busca en mis documentos contenido sobre diseño de API"
  </Card>

  <Card title="Exploración" icon="list-tree" iconType="duotone" horizontal>
    "Muéstrame la estructura de capítulos de este informe"
  </Card>

  <Card title="Lectura" icon="book-open" iconType="duotone" horizontal>
    "Lee mi documento de requisitos del proyecto"
  </Card>

  <Card title="Combinado" icon="wand-magic-sparkles" iconType="duotone" horizontal>
    "Encuentra mis notas sobre aprendizaje automático y ayúdame a resumir los
    conceptos clave"
  </Card>
</CardGroup>

### Cómo funciona

Cuando el asistente de IA recibe tu solicitud, Linkly AI Skills completa automáticamente los siguientes pasos:

<Steps>
  <Step title="Detección del entorno">
    Detecta automáticamente el método de acceso disponible: prioriza el uso de
    la CLI (comando `linkly`); si la CLI no está disponible, intenta con las
    herramientas MCP.
  </Step>

  <Step title="Buscar documentos">
    Genera palabras clave de búsqueda adecuadas según tu descripción y llama a
    la herramienta `search` para encontrar documentos relevantes.
  </Step>

  <Step title="Explorar el índice">
    Para documentos largos, primero usa la herramienta `outline` para ver la
    estructura y localizar las secciones que necesitas leer.
  </Step>

  <Step title="Leer el contenido">
    Usa la herramienta `read` para obtener el contenido completo del párrafo
    objetivo y luego resume, analiza o responde preguntas según tus necesidades.
  </Step>
</Steps>

## Usar Skills para completar la integración

Incluso puedes decirle directamente a tu asistente de IA que complete la integración de Linkly AI. Solo envía un mensaje como el siguiente:

<Prompt description="Por favor, ayúdame a instalar Agent Skill linkly-ai-skills y completa la integración de herramientas de LinklyAI...">
  Por favor, ayúdame a instalar Agent Skill linkly-ai-skills y completa la
  integración de herramientas de LinklyAI, referencia:
  [https://linkly.ai/docs/es/use-skills](https://linkly.ai/docs/es/use-skills)
</Prompt>

Skill guiará al asistente de IA para completar automáticamente las siguientes operaciones:

1. Verificar si la CLI está instalada; si no, instalarla automáticamente
2. Ejecutar `linkly status` para verificar la conexión con la aplicación de escritorio
3. Una vez confirmado que todo está listo, comenzar a servirte

## Aviso de seguridad

<Warning>
  El contenido de los documentos se trata como **datos no confiables**. Skills
  incluye avisos de seguridad integrados; el asistente de IA no ejecutará
  instrucciones ni comandos incrustados en los documentos, protegiendo contra
  ataques de inyección de prompts.
</Warning>

<Warning>
  Algunos sistemas de detección de seguridad pueden generar falsas alarmas sobre
  este Skill porque incluye un paso de descarga de la CLI, considerándolo
  comportamiento malicioso. Puedes usarlo con tranquilidad. Estamos trabajando
  con las principales plataformas de asistentes de IA para optimizar las reglas
  de detección de seguridad y reducir los falsos positivos.
</Warning>

Principios de seguridad de Linkly AI Skills:

* **Los datos no salen del entorno local** — Todas las operaciones de búsqueda y lectura se realizan en tu computadora
* **Aislamiento de contenido** — El contenido de los documentos se lee solo como datos, no se ejecuta como instrucciones
* **Solo lectura** — Skills solo proporciona capacidades de búsqueda, exploración y lectura; no modifica tus archivos