What are skills
Skills teach Agent how you work. As you build together, you create useful context about your project, but that context normally disappears when the chat ends. Skills preserve what you’ve learned so Agent can apply it consistently. Tasks that were previously inconsistent become more reliable, producing better results each time. For example, a design system skill ensures Agent uses your exact colors and spacing rules. A bug fix skill captures solutions so Agent remembers them for next time.When to use skills
You can create skills for anything, from how you structure your code to how you write your docs. Here are some examples to get you started:| Use Case | Example Scenario |
|---|---|
| Design systems | Create a skill for your design system so Agent uses consistent colors, spacing, and components |
| New frameworks | Add a skill for Remotion when building video features or other specialized libraries |
| Media creation | Teach Agent photography principles for AI-generated images |
| Learning how your app works | After fixing a complex bug together, create a skill that captures what you both learned about your app’s architecture |
Adding skills to your project
Skills become part of your project once they’re added to the/.agent/skills directory. You can create skills naturally through conversation with Agent, install pre-built skills from the community, or write custom skills for specialized needs.
Create with Agent
The most natural way to create skills is through conversation. After solving a problem together, ask Agent to capture what it learned. The skill writes itself from shared context.Upload and manage custom skills
You can upload and manage skills directly through the Workspace. Open the Skills pane to view installed skills, upload custom skill files, or remove skills you no longer need.Install from the skills directory
The Agent Skills directory offers community-contributed skills you can install directly. Replit supports installation via the npx skills CLI:/.agent/skills directory.
Technical reference
Skills are stored in your project’s/.agent/skills directory. Each skill follows the Agent Skills specification, which defines the structure and format for skill files.
Agent reads all skills in this directory and considers them when working on tasks. Skills persist in your project, so they remain available across Agent sessions and can be committed to version control for team sharing.
Skills can be scoped to different levels:
- Project-level: Specific to one codebase, versioned with your code in
/.agent/skills - User-level: Your personal toolkit that follows you across projects
- Enterprise (coming soon): Company-wide standards and shared knowledge
Skills work best when they capture specific, repeatable patterns rather than
general guidance. Focus on concrete workflows, established conventions, and
proven solutions from your project.
Working with other AI coding tools
Import skills from other AI coding tools
Import skills from other AI coding tools
If you work across multiple AI coding tools, rulesync has Replit support and helps you maintain consistent configurations.You can import skills from other AI coding assistants:This allows you to maintain a single set of skills that work across different development environments.
Next steps
Skills complement Agent’s core capabilities by adding project-specific knowledge:- Learn more about Agent and how it builds applications
- Explore other AI-powered features available in Replit
- Review the Agent Skills specification to understand skill structure
- For examples of custom skills, see Anthropic’s skills repository
- Browse community skills at skills.sh