# Skill pour agents IA : construire des modèles PDFMonkey


Le skill PDFMonkey est un fichier unique, [`SKILL.md`](/doc-assets/skills/pdfmonkey-templates/SKILL.md), qui apprend à un agent de code à construire des modèles PDFMonkey : les filtres Liquid disponibles, les blocs du Builder et leurs règles de style, comment écrire des données de test réalistes, et comment prévisualiser et publier avec la [CLI](/fr/docs/integrations/cli/).

Une fois installé, vous pouvez demander à votre agent « un modèle de facture avec un logo et un tableau de lignes » et obtenir un modèle que vous pouvez ouvrir et continuer à modifier dans le dashboard.

## Ce qu’il vous faut

- Un agent qui lit les fichiers `SKILL.md`, comme [Claude Code](https://code.claude.com/docs/en/skills).
- Node.js 22.12 ou plus récent, pour la [CLI PDFMonkey](/fr/docs/integrations/cli/) (`npm install -g @pdfmonkey/cli`).
- Votre clé d’API dans la variable d’environnement `PDFMONKEY_API_KEY`. Vous la trouverez sur [la page de votre compte](https://dashboard.pdfmonkey.io/account).

## Installer le skill

### Claude Code

Téléchargez le fichier dans votre dossier personnel de skills pour l’utiliser dans tous vos projets :

```bash
$ mkdir -p ~/.claude/skills/pdfmonkey-templates
$ curl -o ~/.claude/skills/pdfmonkey-templates/SKILL.md https://pdfmonkey.io/doc-assets/skills/pdfmonkey-templates/SKILL.md
```

Pour le partager avec votre équipe, utilisez plutôt `.claude/skills/pdfmonkey-templates/` dans votre dépôt.

### Cursor et autres agents

Copiez le contenu de [`SKILL.md`](/doc-assets/skills/pdfmonkey-templates/SKILL.md) dans les règles de votre projet (par exemple un fichier `.cursor/rules`), ou collez-le au début de votre conversation.

## Ce que vous pouvez demander

- « Crée un modèle Code pour une facture française avec un logo, un tableau de lignes et la TVA. »
- « Construis un certificat en paysage en mode Builder et publie-le. »
- « Génère un document de test à partir du modèle que tu viens de créer et montre-moi le résultat. »

L’agent écrit les fichiers du modèle, crée le modèle avec la CLI, le surveille pour afficher un aperçu en direct, et génère un document de test à partir de vos données d’exemple.

## Bon à savoir

- **Les modèles sont créés en brouillon.** L’agent ne publie que lorsqu’il faut générer des documents, et il doit vous demander avant de publier un modèle déjà en production.
- **Le format de papier et les marges sont des paramètres du modèle.** Ils ne font pas partie des fichiers locaux : modifiez-les dans l’onglet Paramètres du modèle si la valeur par défaut ne convient pas.
- **Les modèles Builder ont besoin d’un préambule** que le dashboard ajoute normalement lors de l’enregistrement. Le skill le connaît ; si un document Builder sort vide, c’est la première chose à vérifier.
- **Vous générez des documents à partir de modèles existants ?** Utilisez plutôt le [serveur MCP](/fr/docs/integrations/mcp/).
- **Votre clé d’API donne un accès complet à votre compte.** Gardez-la hors des fichiers de configuration partagés.


## FAQ

**Un agent IA peut-il construire des modèles PDFMonkey ?**

Oui. Le skill PDFMonkey est un fichier SKILL.md qui apprend à un agent de code comme Claude Code à écrire des modèles Code (Liquid et Tailwind CSS) et Builder, puis à les prévisualiser et les publier avec la CLI PDFMonkey.

**Quels agents peuvent utiliser le skill PDFMonkey ?**

Tout agent qui lit les fichiers SKILL.md, comme Claude Code. Pour les autres outils, comme Cursor, collez le contenu du fichier dans les règles de votre projet ou fournissez-le à l’agent comme contexte.

**Le skill a-t-il besoin du serveur MCP ?**

Non. Le skill pilote la CLI PDFMonkey, qui peut créer et modifier des modèles, ce que le serveur MCP ne sait pas faire. Les deux se complètent : le skill construit les modèles, le serveur MCP génère des documents à partir de ces modèles.