Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Teach Agent how you want to build. Whether you’re starting a new project or building on existing work, Skills let you share your preferences, patterns, and expertise with Agent.
Agent Skills pane showing installed skills

​
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.

​
Two ways to use skills

There are two ways to use skills with Agent, depending on whether you want a skill to apply to a single message or to your entire project.

​
Use a skill in chat

The fastest way to use a skill is to attach it directly to a message. Click the + button next to the chat input, select Use a skill, and browse the available categories. When you select a skill, it appears as a chip attached to your message. Agent uses that skill for the current task only — it does not get installed into your project. This is ideal when you want Agent to perform a one-off task with specialized knowledge. For example, you can select the Stock Analyzer skill and ask Agent to research an investment, or pick the Resume Maker skill to create a polished resume. Skills are organized into the following categories:
CategoryExample skills
Sales & marketingAd Creative, AI SDR, SEO Auditor, Content Machine
CareerAI Recruiter, Resume Maker, Interview Prep
Research & analysisCompetitive Analysis, Deep Research, Supplier Research
Business & financeStock Analyzer, Invoice Generator, Real Estate Analyzer
Documents & toolsExcel Generator, Website Cloner, File Converter, Flashcard Generator
CreativePhoto Editor, Podcast Generator, Branding Generator
ProductivityAI Secretary, Product Manager, Design Thinker
PersonalTravel Assistant, Recipe Creator, Meal Planner, Personal Shopper
You can also type “use the stock analyzer skill” (or any skill name) directly in your message without opening the skill picker — Agent understands the request.

​
Install a skill in your project

When you want Agent to follow a skill consistently across every conversation in a project, install it into your project’s /.agents/skills directory. Installed skills persist across chat sessions and are always available to Agent when it works on your project. This is best for project-specific knowledge like your design system, coding conventions, or solutions to recurring issues.

​
Adding skills to your project

There are several ways to add a skill to your project permanently.

​
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. 
Create a skill for my design system using these color palettes and spacing rules
You can also ask Agent to research and create skills for new domains: 
Research best practices for video generation with Remotion and create a skill

​
Discover and install from the Skills pane

Open the Skills pane in the Project Editor and select the Discover tab to search for community-contributed skills. You can browse by name, search by keyword, and install any skill directly into your project with a single click.
Discover skills tab showing searchable community-contributed skills with install buttons
The Skills pane also shows all skills currently installed in your project. From here, you can enable or disable individual skills and remove ones you no longer need.
Agent Skills pane showing installed skills

​
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: 
npx skills <skill> -a replit
This installs the skill into your project’s /.agents/skills directory.
Skills contain arbitrary content and code. Always review the source before installing a skill from external sources.

​
How skills work

Skills are stored in your project’s /.agents/skills directory. Each skill follows the Agent Skills specification, which defines the structure and format for skill files. Agent sees the name and description of every installed skill, but only loads the full content of a skill when it’s relevant to the current task. This keeps things lightweight — you can have many skills installed without slowing Agent down. Installed 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 project, versioned with your files in /.agents/skills
  • User-level: Your personal toolkit that follows you across projects
  • Enterprise: Company-wide standards baked into custom templates that are pinned to the Agent input box for your organization
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

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:
npx rulesync init
npx rulesync import --targets claudecode --features skills
npx rulesync generate --targets replit --features skills
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: