Warning
This repository is deprecated and is being archived.
The developing-with-streamlit meta-skill now lives in and ships with Streamlit itself — streamlit/streamlit is the canonical source of truth. As of Streamlit 1.60+ the meta-skill is bundled in the pip package at lib/streamlit/.agents/meta-skill/developing-with-streamlit, and streamlit skills installs it from your local install — no download from this repo.
- Recommended:
pip install --upgrade streamlit(1.60+), thenstreamlit skills. - Existing installs keep working. This repo stays public and its
v1tag is preserved, sonpx skills/gh skill/git cloneinstalls continue to resolve;discover.pyruns entirely locally, so archiving does not affect it. - New development and fixes to the meta-skill happen in
streamlit/streamlit, not here.
A lightweight meta-skill that teaches AI coding assistants (Claude Code, Cursor, and others) how to discover and load the Streamlit development skills bundled inside the Streamlit pip package (1.57+).
Agent Skills are specialized instruction sets that enhance AI coding assistants' capabilities for specific tasks. Each skill contains instructions, scripts, and resources that the AI loads dynamically to improve performance on Streamlit development workflows.
The actual skill content (dashboards, themes, layouts, session state, custom components, etc.) ships with Streamlit itself — this repo only contains the entry point that bootstraps discovery.
Starting with Streamlit 1.57, the full set of Streamlit development skills ships inside the Streamlit pip package itself. This repository provides a lightweight meta-skill that teaches agents how to discover and load those bundled skills.
The meta-skill (developing-with-streamlit/SKILL.md):
- Detects the active Python interpreter (virtualenv, conda, pipenv, poetry, pdm, uv, or system)
- Locates the installed Streamlit package path
- Points the agent to the bundled skills at
<streamlit_path>/.agents/skills/ - Falls back to the online docs for older Streamlit versions
Because discovery happens dynamically against whichever interpreter is active, a single user-level install of this meta-skill works across every project on your machine — regardless of which Streamlit version each project pins. Upgrade a project's Streamlit and the agent automatically picks up the newer bundled skills; no re-install needed.
If your project uses Streamlit 1.58 or newer, the easiest way to install the skills — at either project or user level — is the built-in command:
streamlit skillsThe interactive CLI lets you choose where to install:
- Project level — the bundled skills are symlinked into the current project (under
.agents/skills/, plus.claude/skills/when Claude Code is detected) from the active Streamlit package, so they stay in sync with the installed Streamlit version. - User/global level — installs this repo's meta-skill for your user account, so it works across every project on your machine and resolves the bundled skills dynamically against whichever Streamlit version each project uses.
The command is idempotent — safe to run multiple times. Add --yes to skip the interactive prompt (e.g. in CI or scripts):
streamlit skills --yesThe user/global option above installs the same meta-skill this repository contains (developing-with-streamlit). Install it manually if you're on Streamlit 1.57 (before streamlit skills existed), or if you'd rather manage it through your agent's own skill installer (npx skills, gh skill, etc.).
Install it once at the user level — the meta-skill resolves the bundled skills dynamically from whichever Python interpreter is active, so one global install works across every project and every Streamlit version you use (1.57+). Use one of the per-agent methods below.
skills (docs) is a Vercel-published cross-agent installer that supports Claude Code, Cursor, Copilot, Gemini CLI, Codex, and others — one command, all agents:
npx skills add streamlit/agent-skills -s developing-with-streamlit -g-s picks the specific skill from this repo; -g installs at the user level (global) so it works across every project. Drop -g to install into the current project's .<agent>/skills/ directory instead. See npx skills add --help for the full flag list.
Anthropic's Claude Code does not yet ship an official skills install CLI. Clone this repo and drop the skill folder into your user-level Claude skills directory:
git clone https://github.com/streamlit/agent-skills.git
cp -r agent-skills/developing-with-streamlit ~/.claude/skills/If you prefer project-scoped install, copy to .claude/skills/ in your repo root instead. See the Claude Code skills docs for the latest guidance.
gh skill install streamlit/agent-skills developing-with-streamlit --scope userAvailable via the GitHub CLI (gh) as of April 2026. Drop --scope user to install to the current repo only, or pin a version with developing-with-streamlit@v1. See the Copilot agent skills docs.
The same GitHub CLI supports Cursor via --agent:
gh skill install streamlit/agent-skills developing-with-streamlit --agent cursor --scope userSee the Cursor skills docs for alternative install flows (Settings UI, manual placement in ~/.cursor/skills/).
gemini skills install https://github.com/streamlit/agent-skills.gitDefaults to ~/.gemini/skills/ (user scope). Add --scope workspace to install locally instead. See the Gemini CLI skills docs.
Codex installs skills interactively. From inside a Codex session, run:
$skill-installer
Then point the installer at streamlit/agent-skills. Skills land in ~/.codex/skills/ (user). See the Codex skills docs.
Already installed — Cortex Code ships this skill by default; no manual step required.
See CONTRIBUTING.md for guidelines on creating new skills.
- Agent Skills Specification
- Agent Skills Best Practices
- Anthropic Skills Repository
- Streamlit Documentation
- Streamlit API Reference
This project is licensed under the Apache 2.0 License - see individual skills for their specific licenses.