Skip to content
Back to search

gribouille

MarketplaceWorks with Claude CodeGitHub

Author grammar-of-graphics plots with the gribouille Typst library.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mcanouil/gribouille with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mcanouil/gribouille'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mcanouil--gribouille/badge.svg)](/listings/mcanouil--gribouille)

HTML

<a href="/listings/mcanouil--gribouille"><img src="/api/listings/mcanouil--gribouille/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "gribouille",
  3. "owner": { "name": "Mickaël Canouil" },
  4. "description": "Author grammar-of-graphics plots with the gribouille Typst library.",
  5. "plugins": [
  6. {
  7. "name": "gribouille",
  8. "source": "./",
  9. "description": "Author grammar-of-graphics plots with the gribouille Typst library."
  10. }
  11. ]
  12. }
README.md · README · 132 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Gribouille <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mcanouil/gribouille/refs/heads/main/docs/assets/images/logo-stacked-dark.svg"><source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mcanouil/gribouille/refs/heads/main/docs/assets/images/logo-stacked.svg"><img align="right" width="120" alt="Gribouille logo." src="https://raw.githubusercontent.com/mcanouil/gribouille/refs/heads/main/docs/assets/images/logo-stacked.svg"></picture>
  2. Create elegant graphics with the **Grammar of Graphics** for Typst.
  3. _Gribouille_ is French for "scribble".
  4. The library implements Wilkinson's **Grammar of Graphics** in a declarative API for Typst documents, inspired by [`ggplot2`](https://ggplot2.tidyverse.org) (R) and [`plotnine`](https://plotnine.org) (Python).
  5. Documentation: <https://m.canouil.dev/gribouille>.
  6. > [!WARNING]
  7. > _Gribouille_ is in active development.
  8. ## Quick look
  9. ```typst
  10. #import "@preview/gribouille:0.8.0": *
  11. #let species-colours = (
  12. Adelie: rgb("#ff8c00"),
  13. Chinstrap: rgb("#008B8B"),
  14. Gentoo: rgb("#800080"),
  15. )
  16. #plot(
  17. data: penguins,
  18. mapping: aes(
  19. x: "flipper-len",
  20. y: "body-mass",
  21. colour: "species",
  22. fill: "species",
  23. shape: "species",
  24. ),
  25. layers: (
  26. geom-point(size: 2pt, alpha: 0.25, stroke: 0.5pt, colour: rgb("#ffffff")),
  27. geom-smooth(method: "lm", se: true, alpha: 0.2),
  28. geom-mark(method: "hull", expand: 5pt, alpha: 0.25),
  29. geom-errorbar(stat: stat-summary(fun: "mean-sd"), width: 5pt),
  30. geom-errorbarh(stat: stat-summary(fun: "mean-sd"), height: 5pt),
  31. geom-label(
  32. stat: stat-summary(fun: "mean"),
  33. mapping: aes(label: "species"),
  34. colour: rgb("#ffffff"),
  35. size: 8pt,
  36. ),
  37. ),
  38. scales: scales(
  39. x: scale-continuous(),
  40. y: scale-continuous(labels: format-comma()),
  41. colour: scale-discrete(
  42. limits: species-colours.keys(),
  43. palette: species-colours.values(),
  44. ),
  45. fill: scale-discrete(
  46. limits: species-colours.keys(),
  47. palette: species-colours.values(),
  48. ),
  49. ),
  50. labels: labels(
  51. title: typst("Penguins *Dataset*"),
  52. subtitle: typst({
  53. [Flipper length vs body mass by species: ]
  54. species-colours
  55. .pairs()
  56. .map(p => text(fill: p.at(1), weight: "bold")[#p.at(0)])
  57. .join(", ")
  58. }),
  59. caption: "Data from Palmer Archipelago (Antarctica) penguin dataset.",
  60. colour: "Species",
  61. fill: "Species",
  62. shape: "Species",
  63. x: "Flipper Length (mm)",
  64. y: "Body Mass (g)",
  65. ),
  66. theme: theme-minimal(),
  67. width: 12cm,
  68. height: 9cm,
  69. )
  70. ```
  71. ## AI assistants
  72. The documentation ships a machine-readable copy for large language models at <https://m.canouil.dev/gribouille/llms.txt>.
  73. Every page also has a `.llms.md` companion.
  74. An installable skill teaches coding agents to author _Gribouille_ plots against that reference.
  75. Install it with the agent-neutral [`skills`](https://github.com/vercel-labs/skills) CLI:
  76. ```bash
  77. npx skills add mcanouil/gribouille
  78. ```
  79. The repository also doubles as a plugin marketplace:
  80. ```text
  81. /plugin marketplace add mcanouil/gribouille
  82. /plugin install gribouille@gribouille
  83. ```
  84. See the [AI Assistants guide](https://m.canouil.dev/gribouille/guides/ai-assistants.html) for details.
  85. ## Dependencies
  86. See [`typst.toml`](typst.toml) and [`src/deps.typ`](src/deps.typ) for the authoritative Typst compiler and CeTZ versions.
  87. ## Contributing
  88. > [!NOTE]
  89. > Gribouille is an unfunded spare-time project, and the API is still settling.
  90. > Bug reports and ideas are welcome on the issue tracker.
  91. >
  92. > I do not accept pull requests for now.
  93. > The internals shift between releases.
  94. > Every review costs time that I must take from the work that moves the library forward.
  95. > I am also especially careful in the current climate of unreviewed LLM-authored patches.
  96. > Once the surface is stable I will revisit and open the door.
  97. >
  98. > Thanks in advance for your patience and your understanding.
  99. Contributions are welcome.
  100. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for bug reporting, development setup, and commit conventions.
  101. Short identifiers used across the source tree (`ctx`, `spec`, `mapping`, `cx`, `cy`, `lo`, `hi`, …) are catalogued in [`GLOSSARY.md`](GLOSSARY.md).
  102. ## Citation
  103. If you use _Gribouille_ in your work, cite it.
  104. Citation metadata is provided in [`CITATION.cff`](CITATION.cff).
  105. GitHub renders it via the "Cite this repository" widget on the repository sidebar.
  106. ## License
  107. This project is licensed under the MIT License.
  108. See the [LICENSE](LICENSE) file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.