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

# Utiliser les Skills

> Installez nos Skills soigneusement élaborés pour permettre à votre assistant IA de mieux exploiter Linkly AI afin d'obtenir du contexte depuis vos documents locaux, améliorant considérablement l'efficacité.

## Présentation des Skills

Les Agent Skills sont des packs de compétences conformes au standard ouvert [agentskills.io](https://agentskills.io). Les Linkly AI Skills enseignent à votre assistant IA comment se connecter et utiliser les outils de Linkly AI, permettant ainsi à l'IA de rechercher, parcourir et lire vos documents locaux.

**Pourquoi avez-vous besoin des Skills ?**

Après l'installation de Linkly AI Desktop, vous disposez déjà de puissantes capacités d'indexation et de recherche documentaire. Cependant, les assistants IA (comme Claude Code, Codex) ne savent pas comment utiliser ces outils. Les Skills fonctionnent comme un « mode d'emploi » qui permet à l'assistant IA de maîtriser automatiquement les bonnes pratiques d'utilisation, notamment :

* Comment détecter et se connecter à Linkly AI
* Quand rechercher, quand consulter le sommaire, quand lire le texte intégral
* Comment gérer la lecture paginée des documents longs
* Comment traiter le contenu des documents en toute sécurité

## Installer les Skills

<Tabs>
  <Tab title="skills.sh (recommandé)" icon="bolt">
    Installez en une commande sur tous les assistants IA compatibles avec [skills.sh](https://skills.sh) :

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

    Ou installez pour un assistant IA spécifique :

    ```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">
    Clonez les Skills dans le répertoire skills de Claude Code :

    ```bash theme={null}
    # Niveau personnel (disponible pour tous les projets)
    git clone https://github.com/LinklyAI/linkly-ai-skills.git ~/.claude/skills/linkly-ai

    # Niveau projet (disponible uniquement pour le projet actuel)
    git clone https://github.com/LinklyAI/linkly-ai-skills.git .claude/skills/linkly-ai
    ```
  </Tab>

  <Tab title="Codex CLI" icon="code">
    Clonez les Skills dans le répertoire 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 (version web)" icon="globe">
    <Steps>
      <Step title="Télécharger le pack Skills">
        Rendez-vous sur la page [GitHub Releases](https://github.com/LinklyAI/linkly-ai-skills/releases) et téléchargez le dernier fichier `linkly-ai.zip`.
      </Step>

      <Step title="Téléverser sur Claude.ai">
        Dans Claude.ai, ouvrez Settings → Capabilities → Skills, puis téléversez le fichier zip téléchargé.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Vous pouvez également l'installer via [ClawHub](https://openclaw.org) pour une utilisation avec OpenClaw :

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

## Utiliser les Skills

Après l'installation des Skills, **vous n'avez aucune commande spéciale à apprendre**. Posez simplement vos questions en langage naturel à l'assistant IA, les Skills identifient automatiquement votre intention et déclenchent les opérations appropriées.

### Activation automatique

L'assistant IA détermine automatiquement s'il doit utiliser les outils de Linkly AI en fonction des mots-clés de votre requête. Par exemple :

<CardGroup cols={1}>
  <Card title="Recherche" icon="magnifying-glass" iconType="duotone" horizontal>
    « Recherche dans mes documents le contenu relatif à la conception d'API »
  </Card>

  <Card title="Navigation" icon="list-tree" iconType="duotone" horizontal>
    « Montre-moi la structure des chapitres de ce rapport »
  </Card>

  <Card title="Lecture" icon="book-open" iconType="duotone" horizontal>
    « Lis mon document de spécifications du projet »
  </Card>

  <Card title="Combiné" icon="wand-magic-sparkles" iconType="duotone" horizontal>
    « Trouve mes notes sur le machine learning, puis résume les concepts clés »
  </Card>
</CardGroup>

### Fonctionnement

Lorsque l'assistant IA reçoit votre requête, les Linkly AI Skills effectuent automatiquement les étapes suivantes :

<Steps>
  <Step title="Détection de l'environnement">
    Détection automatique des méthodes d'accès disponibles : utilisation
    prioritaire du CLI (`linkly`), et si le CLI n'est pas disponible, tentative
    via les outils MCP.
  </Step>

  <Step title="Recherche de documents">
    Génération de mots-clés de recherche appropriés à partir de votre
    description, puis appel de l'outil `search` pour trouver les documents
    pertinents.
  </Step>

  <Step title="Consultation du sommaire">
    Pour les documents longs, consultation préalable de la structure via l'outil
    `outline` pour localiser les sections à lire.
  </Step>

  <Step title="Lecture du contenu">
    Utilisation de l'outil `read` pour obtenir le contenu complet des
    paragraphes ciblés, puis synthèse, analyse ou réponse en fonction de vos
    besoins.
  </Step>
</Steps>

## Réaliser l'intégration avec les Skills

Vous pouvez même demander directement à l'assistant IA de compléter l'intégration de Linkly AI. Envoyez simplement un prompt similaire au suivant :

<Prompt description="Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration des outils LinklyAI...">
  Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration
  des outils LinklyAI, en référence : [https://linkly.ai/docs/fr/use-skills](https://linkly.ai/docs/fr/use-skills)
</Prompt>

Le Skill guidera l'assistant IA pour effectuer automatiquement les opérations suivantes :

1. Vérifier si le CLI est installé, et l'installer automatiquement si ce n'est pas le cas
2. Exécuter `linkly status` pour vérifier la connexion avec l'application de bureau
3. Confirmer que tout est prêt, puis commencer à vous servir

## Notes de sécurité

<Warning>
  Le contenu des documents est considéré comme des **données non fiables**. Les
  Skills intègrent des consignes de sécurité : l'assistant IA n'exécutera pas
  les instructions ou commandes intégrées dans les documents, prévenant ainsi
  les attaques par prompt injection.
</Warning>

<Warning>
  Certains systèmes de détection de sécurité peuvent signaler à tort ce Skill
  comme malveillant en raison de l'étape de téléchargement du CLI. Soyez
  rassuré. Nous travaillons avec les principales plateformes d'assistants IA
  pour optimiser les règles de détection et réduire les faux positifs.
</Warning>

Principes de sécurité des Linkly AI Skills :

* **Les données restent en local** — Toutes les opérations de recherche et de lecture sont effectuées sur votre ordinateur
* **Isolation du contenu** — Le contenu des documents est uniquement lu comme données, jamais exécuté comme instructions
* **Opérations en lecture seule** — Les Skills offrent uniquement des capacités de recherche, de navigation et de lecture, sans modifier vos fichiers