Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

docs: skills (#8321)

Akshay Agrawalb6adf07d2a4f
diff --git a/docs/guides/generate_with_ai/index.md b/docs/guides/generate_with_ai/index.md
index 9276a96c69..7c0264700e 100644
--- a/docs/guides/generate_with_ai/index.md
+++ b/docs/guides/generate_with_ai/index.md
@@ -2,6 +2,7 @@
| Guide | Description |
|-------|-------------|
+| [Skills](skills.md) | Skills for coding agents |
| [Zero-shot entire notebooks](text_to_notebook.md) | Generate entire notebooks with AI |
| [AI-assisted coding](../editor_features/ai_completion.md) | Refactor code and generate cells with AI |
| [Prompts for the marimo editor](prompts.md) | Collection of prompts to speed up workflows in marimo |
diff --git a/docs/guides/generate_with_ai/skills.md b/docs/guides/generate_with_ai/skills.md
new file mode 100644
index 0000000000..067bc976af
--- /dev/null
+++ b/docs/guides/generate_with_ai/skills.md
@@ -0,0 +1,38 @@
+# Skills
+
+We have prepared a collection of skills to help coding agents work with marimo.
+Install our official skills with a single command:
+
+```bash
+npx skills add marimo-team/skills
+```
+
+**Use cases.** Use these skills to
+
+- convert Jupyter notebooks or other artifacts to marimo notebooks,
+- make bespoke interactive UI elements or widgets for specific use cases,
+- and otherwise author high-quality standalone notebooks.
+
+**Feedback.** We welcome feedback at our [GitHub repository](https://github.com/marimo-team/skills/issues).
+
+!!! tip "Watching for changes to notebooks on disk"
+
+ When using marimo with Claude Code, configure the marimo editor to
+ automatically reload when Claude edits your notebook by starting
+ marimo with the `watch` flag: `marimo edit --watch notebook.py`.
+ (Learn more in our [watching guide](/guides/editor_features/watching.md).)
+ You can also configure marimo to automatically reload affected
+ cells when auxiliary files change on disk using
+ [module autoreloading](/guides/editor_features/module_autoreloading.md).
+
+## What are skills?
+
+Skills are folders of instructions, scripts, and resources that Claude and
+other agents load dynamically to improve performance on specialized
+tasks.
+
+To learn more about skills, check out:
+
+- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills)
+- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)
+- [skills.sh](https://skills.sh/)
diff --git a/mkdocs.yml b/mkdocs.yml
index 9380d49c71..749d8fd895 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -107,6 +107,7 @@ nav:
- Using uv: guides/package_management/using_uv.md
- Generate with AI:
- Generate with AI: guides/generate_with_ai/index.md
+ - Skills: guides/generate_with_ai/skills.md
- Generate entire notebooks: guides/generate_with_ai/text_to_notebook.md
- AI-assisted coding: guides/editor_features/ai_completion.md
- Prompts: guides/generate_with_ai/prompts.md