Skills
Reflex Agent Skills give AI coding assistants up-to-date guidance for building Reflex applications. They package Reflex-specific knowledge, setup steps, and process-management workflows into reusable SKILL.md files that agents can load when the conversation or codebase calls for them.
The skills are maintained in the reflex-dev/agent-skills repository and are designed for agents that support the Agent Skills standard, including Claude Code, Cursor, OpenCode, OpenAI Codex, and Pi.
Current Reflex guidance
Point agents to the right Reflex docs for state, vars, components, routing, styling, deployment, and more.
Python environment workflow
Teach agents how to create a virtual environment, install Reflex, and initialize a new project safely.
Process management
Give agents a repeatable way to compile, run, restart, and debug Reflex apps without guessing at processes.
Pairs well with MCP
Use skills for durable local instructions and MCP for structured lookup of current docs and component data.
When to Use Skills
Use Reflex Agent Skills when you want an AI assistant to follow Reflex-specific workflows instead of relying only on general training data. They are especially useful when an assistant needs to:
- Build or edit a Reflex app.
- Set up a new Python environment.
- Decide which Reflex docs apply to the task.
- Compile, run, restart, or debug a local Reflex server.
- Keep generated code aligned with current Reflex patterns.
Skills load contextually. For example, when an assistant sees a Python file importing reflex as rx, it can load the Reflex docs skill. When you ask it to start a new app, it can load the Python environment setup skill before running project commands.
Skills vs MCP
Skills and MCP solve related but different problems. For the best experience, use both.
Skills
Local instruction packs that tell the agent how to work with Reflex, which workflows to follow, and which references matter for common development tasks.
MCP
Structured runtime access to Reflex documentation and component information through a hosted server. Use it when an agent or editor can call MCP tools directly.
Skills
Local instruction packs that tell the agent how to work with Reflex, which workflows to follow, and which references matter for common development tasks.
MCP
Structured runtime access to Reflex documentation and component information through a hosted server. Use it when an agent or editor can call MCP tools directly.
Installation
Choose the install path that matches your assistant.
Install the plugin from the Claude Code plugin marketplace:
Restart or refresh Claude Code after installation if the skills do not appear immediately.
Included Skills
The Reflex skill pack includes three core skills.
The reflex-docs skill gives the assistant a Reflex-specific reference map and a summary of the framework's core concepts.
Use this skill when the assistant is:
- Building full-stack Python web apps with Reflex.
- Writing files that import
reflexor use therxnamespace. - Creating components.
- Managing state, vars, computed vars, or event handlers.
- Working with routing, styling, database models, assets, authentication, client storage, API routes, custom components, or wrapped React components.
It points the assistant to docs for:
- Core app structure: getting started, components, state and vars, events, pages, and routing.
- UI and styling: styling, assets, the component library, and recipes.
- Backend features: database models, authentication, client storage, API routes, and API reference.
- Advanced integrations: custom components and wrapped React components.
It also reminds the assistant to prefer current Reflex documentation over pre-trained knowledge when there is a conflict.
Recommended Workflow
- Install Reflex Agent Skills in your assistant.
- Ask the assistant to create or initialize a Reflex app.
- The assistant should load
setup-python-env. - After the environment is ready, the assistant can run
reflex init. - As the app is built, the assistant should use
reflex-docsfor current framework guidance. - Before handing the app back, the assistant should use
reflex-process-managementto compile or run the project.
Keeping Skills Updated
Because Reflex evolves quickly, update the skill pack regularly.
If you installed through a marketplace or skills CLI, update through that same tool. If you cloned the repository manually, pull the latest changes:
Then copy the updated skill folders back into your assistant's skills directory if your setup does not read directly from the cloned repository.
Troubleshooting
Check that:
- Your assistant supports Agent Skills.
- The skill folders are in the correct skills directory.
- Each skill folder contains a
SKILL.mdfile. - The assistant was restarted or refreshed after installation if required.
Contributing
Each skill lives in skills/<name>/ and contains a SKILL.md manifest. To contribute new guidance, update or add a skill in the reflex-dev/agent-skills repository and follow the Agent Skills spec for the skill format.