Cecil fournit des skills d’agents : des instructions que les agents de code IA (Claude Code, GitHub Copilot, Cursor, etc.) chargent pour travailler correctement avec Cecil, en suivant ses conventions.

Installation

Avec GitHub CLI :

gh skill install cecilapp/cecil

Ou avec npx skills :

npx skills add cecilapp/cecil

Utilisation

Une fois installées, demandez à votre agent de créer, générer, configurer ou déployer un site Cecil, ou de créer un thème : il utilise automatiquement la skill correspondante.

Exemples de prompts :

• « Crée un blog Cecil avec une version anglaise et une version française. »
• « Ajoute une section projects avec une liste de cartes sur la page d’accueil. »
• « Transforme les layouts de ce site en un thème Cecil réutilisable. »

Les modèles de langage lisent plus facilement le Markdown que le HTML. Cecil leur fournit deux formats de sortie :

• llms : un fichier llms.txt, index du site ;
• markdown : une version Markdown de chaque page.

Les deux sont désactivés par défaut.

llms.txt

Depuis la version 8.114.0, le format llms génère la page d’accueil sous la forme d’un fichier llms.txt à la racine du site. Il contient :

• le titre et la description du site ;
• les liens du menu principal (les URL externes sont ignorées) ;
• les sections de premier niveau et leurs pages (les sous-sections sont imbriquées), avec leur titre et leur description.

Pour l’activer, ajoutez le format à la page d’accueil :

output:
  pagetypeformats:
    homepage:
      llms: true

Avec le template metatags, la page d’accueil HTML référence le fichier avec une balise <link rel="describedby" type="text/markdown">.

Exclure du contenu

Pour exclure une page ou une section (et ses pages) de llms.txt, définissez llms: false dans son front matter :

---
title: "Mentions légales"
llms: false
---

Les sections non publiées et exclues ne sont pas listées.

Pages Markdown

Le format markdown génère une page sous la forme d’un fichier Markdown, à côté de sa version HTML (ex. : blog/post-1.md pour blog/post-1/index.html). Le fichier contient le titre et le corps de la page ; une section liste ses pages.

Pour générer toutes les pages et sections en Markdown :

output:
  pagetypeformats:
    page:
      markdown: true
    section:
      markdown: true

Ou pour une seule page, avec la variable output :

---
output: [html, markdown]
---

Avec le template metatags, la page HTML référence sa version Markdown avec une balise <link rel="alternate" type="text/markdown">. Les liens de llms.txt pointent vers la version Markdown des pages lorsqu’elle existe.

Templates

Pour personnaliser ces sorties, surchargez les templates par défaut dans votre répertoire layouts (voir les règles de recherche) :

• home.llms.twig : le fichier llms.txt ;
• page.markdown.twig, list.markdown.twig et home.markdown.twig : les pages Markdown.

Cecil génère un fichier robots.txt qui autorise tous les robots. Pour bloquer les robots d’IA (ou certains d’entre eux), ajoutez vos propres règles en créant une page avec le chemin robots :

pages/robots.md

---
layout: robots
output: txt
---
User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

Le corps de la page est ajouté aux règles par défaut (voir les pages par défaut).