Le skill data.gouv.fr

Installer le skill data.gouv.fr pour votre assistant IA.

Le skill data.gouv.fr est une documentation structurée pour aider un assistant IA à utiliser plus efficacement les APIs de la plateforme (catalogue, métriques et données tabulaires).

Le skill est encore expérimental. Le contenu, les usages et la configuration peuvent évoluer. Vos retours sont les bienvenus !

Comme pour tout usage de LLM, les réponses peuvent être incomplètes, erronées ou inclure des hallucinations (informations inventées par le modèle). Vérifiez toujours les résultats avant réutilisation.

Pour des usages sérieux (applications, visualisations, traitements automatisés), privilégiez l'utilisation directe des APIs de data.gouv.fr : elles offrent des réponses structurées, traçables et reproductibles.

Installation

Installez le skill en suivant la procédure correspondant à votre assistant.

Les commandes ci-dessous sont prévues pour Linux/macOS. Si vous utilisez Windows, suivez la documentation officielle de votre assistant pour adapter les chemins et commandes.

Le skill est maintenu dans le dépôt datagouv-skill. Pour les détails complets d'installation et de structure (SKILL.md), consultez la section Installation du README.

Claude Code

Consultez la documentation Claude Code (Skills).

# Installation personnelle
mkdir -p ~/.claude/skills/datagouv-apis
cp SKILL.md ~/.claude/skills/datagouv-apis/

# Installation dans le projet
mkdir -p .claude/skills/datagouv-apis
cp SKILL.md .claude/skills/datagouv-apis/

Cursor

Consultez la documentation Cursor (Skills).

Option 1 (recommandée) : ajouter une règle distante GitHub dans Settings > Rules > Project Rules > Add Rule > Remote Rule (Github), puis renseigner le dépôt datagouv/datagouv-skill.

Option 2 (copie locale) :

# Installation personnelle
mkdir -p ~/.cursor/skills/datagouv-apis
cp SKILL.md ~/.cursor/skills/datagouv-apis/

# Installation dans le projet
mkdir -p .cursor/skills/datagouv-apis
cp SKILL.md .cursor/skills/datagouv-apis/

Claude Desktop

# Linux
mkdir -p ~/.config/claude/skills/datagouv-apis
cp SKILL.md ~/.config/claude/skills/datagouv-apis/

# macOS
mkdir -p ~/Library/Application\ Support/Claude/skills/datagouv-apis
cp SKILL.md ~/Library/Application\ Support/Claude/skills/datagouv-apis/

Mistral Vibe

Consultez la documentation Mistral (Agents & Skills).

Les chemins ci-dessous correspondent à la configuration actuellement documentée dans le dépôt du skill. Vérifiez la documentation Mistral si votre version utilise une structure différente.

# Installation globale
mkdir -p ~/.vibe/skills/datagouv-apis
cp SKILL.md ~/.vibe/skills/datagouv-apis/

# Installation dans le projet
mkdir -p .vibe/skills/datagouv-apis
cp SKILL.md .vibe/skills/datagouv-apis/

Codex CLI

Consultez la documentation Codex (Skills).

# Installation utilisateur
mkdir -p ~/.agents/skills/datagouv-apis
cp SKILL.md ~/.agents/skills/datagouv-apis/

# Installation dans le projet
mkdir -p .agents/skills/datagouv-apis
cp SKILL.md .agents/skills/datagouv-apis/

ChatGPT

Collez le contenu de SKILL.md au début de la conversation, ou pointez vers la version brute :

https://raw.githubusercontent.com/datagouv/datagouv-skill/main/SKILL.md

Autres assistants

Copiez SKILL.md dans un dossier reconnu par votre client comme dossier de skills, par exemple datagouv-apis/SKILL.md.

Après installation, redémarrez votre assistant si nécessaire.

Vérifier l’installation

Une fois le skill installé :

1. Testez une demande simple portant sur data.gouv.fr (jeu de données, API, métriques ou ressource tabulaire).

2. Vérifiez que les réponses sont plus précises, mieux structurées et cohérentes avec la documentation de la plateforme.

3. Validez systématiquement les résultats avant réutilisation.

Pour aller plus loin

Ce guide couvre l’installation du skill. Pour les détails complets (cas particuliers, formats et mises à jour), consultez le README du dépôt datagouv-skill.