Saltar al contenido principal

Introducción a Skills

Agent Skills es un paquete de habilidades que sigue el estándar abierto de 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

Usa skills.sh para instalar en todos los asistentes de IA compatibles con un solo comando:
npx skills add LinklyAI/linkly-ai-skills
O instala en un asistente de IA específico:
# Claude Code
npx skills add LinklyAI/linkly-ai-skills -a claude-code

# Codex CLI
npx skills add LinklyAI/linkly-ai-skills -a codex
También puedes instalarlo en OpenClaw a través de ClawHub:
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:

Búsqueda

“Busca en mis documentos contenido sobre diseño de API”

Exploración

“Muéstrame la estructura de capítulos de este informe”

Lectura

“Lee mi documento de requisitos del proyecto”

Combinado

“Encuentra mis notas sobre aprendizaje automático y ayúdame a resumir los conceptos clave”

Cómo funciona

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

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.
2

Buscar documentos

Genera palabras clave de búsqueda adecuadas según tu descripción y llama a la herramienta search para encontrar documentos relevantes.
3

Explorar el índice

Para documentos largos, primero usa la herramienta outline para ver la estructura y localizar las secciones que necesitas leer.
4

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.

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:

Por favor, ayúdame a instalar Agent Skill linkly-ai-skills y completa la integración de herramientas de LinklyAI...

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

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.
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.
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