Cecil provides agent skills: instructions that AI coding agents (Claude Code, GitHub Copilot, Cursor, etc.) load to work with Cecil the right way, following its conventions.
\n| Skill | \nUse it to | \n
|---|---|
cecil | \nCreate, configure, build and deploy a site: content, front matter, templates, assets, configuration, etc. | \n
cecil-theme | \nCreate, structure and package a theme (visual theme or component theme) for Composer. | \n
With the GitHub CLI:
\ngh skill install cecilapp/cecilOr with npx skills:
npx skills add cecilapp/cecilOnce installed, ask your agent to create, build, configure or deploy a Cecil site, or to create a theme: it uses the matching skill automatically.
\nExamples of prompts:
\nprojects section with a list of cards on the homepage.”Language models read Markdown more easily than HTML. Cecil provides two output formats for them:
\nllms: a llms.txt file, an index of the site;markdown: a Markdown version of each page.Both are disabled by default.
\nSince version 8.114.0, the llms format renders the homepage as a llms.txt file at the root of the site. It contains:
To enable it, add the format to the homepage:
\noutput:\n pagetypeformats:\n homepage:\n llms: trueWith the metatags template, the HTML homepage references the file with a <link rel=\"describedby\" type=\"text/markdown\"> tag.
To exclude a page or a section (and its pages) from llms.txt, set llms: false in its front matter:
\ntitle: \"Legal notice\"\nllms: false\nUnpublished and excluded sections are not listed.
\nThe markdown format renders a page as a Markdown file, next to its HTML version (e.g.: blog/post-1.md for blog/post-1/index.html). The file contains the title and the body of the page; a section lists its pages.
To render all pages and sections in Markdown:
\noutput:\n pagetypeformats:\n page:\n markdown: true\n section:\n markdown: trueOr for a single page, with the output variable:
\noutput: [html, markdown]\nWith the metatags template, the HTML page references its Markdown version with a <link rel=\"alternate\" type=\"text/markdown\"> tag. The links of llms.txt point to the Markdown version of the pages when it exists.
To customize these outputs, override the default templates in your layouts directory (see lookup rules):
home.llms.twig: the llms.txt file;page.markdown.twig, list.markdown.twig and home.markdown.twig: the Markdown pages.Cecil generates a robots.txt file that allows all crawlers. To block AI crawlers (or some of them), add your own rules by creating a page with the robots path:
pages/robots.md
\n\nlayout: robots\noutput: txt\n\nUser-agent: GPTBot\nDisallow: /\n\nUser-agent: ClaudeBot\nDisallow: /\n\nUser-agent: Google-Extended\nDisallow: /The body of the page is appended to the default rules (see default pages).
\n", "language": "en" } ] }