> ## 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.
# Agent Skills
> Learn how to extend Agent with reusable skills that automate tasks and add specialized functionality.
export const WistiaEmbed = ({videoId, title = "Wistia video", playerColor = "FF0000", controlsVisibleOnLoad = false}) => {
if (!videoId) {
return null;
}
const url = "https://fast.wistia.net/embed/iframe/" + videoId + "?seo=false&playerColor=" + playerColor + "&controlsVisibleOnLoad=" + controlsVisibleOnLoad;
return
;
};
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.
## 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:
| Category | Example skills |
| ----------------------- | -------------------------------------------------------------------- |
| **Sales & marketing** | Ad Creative, AI SDR, SEO Auditor, Content Machine |
| **Career** | AI Recruiter, Resume Maker, Interview Prep |
| **Research & analysis** | Competitive Analysis, Deep Research, Supplier Research |
| **Business & finance** | Stock Analyzer, Invoice Generator, Real Estate Analyzer |
| **Documents & tools** | Excel Generator, Website Cloner, File Converter, Flashcard Generator |
| **Creative** | Photo Editor, Podcast Generator, Branding Generator |
| **Productivity** | AI Secretary, Product Manager, Design Thinker |
| **Personal** | Travel 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.
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.
### Install from the skills directory
The [Agent Skills directory](https://skills.sh) offers community-contributed skills you can install directly. Replit supports installation via the [npx skills CLI](https://github.com/vercel-labs/skills):
```bash theme={null}
npx skills -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](https://agentskills.io/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](/teams/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](https://github.com/dyoshikawa/rulesync) has Replit support and helps you maintain consistent configurations.
You can import skills from other AI coding assistants:
```bash theme={null}
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:
* Read the [Agent Skills tutorial](/tutorials/agent-skills) for a hands-on guide with examples
* Learn more about [Agent](/core-concepts/agent) and how it builds applications
* Explore other [AI-powered features](/core-concepts/how-replit-works) available in Replit
* Review the [Agent Skills specification](https://agentskills.io/specification) to understand skill structure
* For examples of custom skills, see [Anthropic's skills repository](https://github.com/anthropics/skills)
* Browse community skills at [skills.sh](https://skills.sh)
* **Enterprise**: Learn how to include skills in [custom templates](/teams/custom-templates) and [design systems](/teams/custom-design-system) for your organization