> ## 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
> Preserve patterns, conventions, and solutions across sessions with Agent Skills.
## What is a Skill?
A skill is a folder. Inside it lives a file called `SKILL.md` with the instructions Agent follows, plus any supporting files you want it to reference. Skills live in your project's `/.agents/skills` directory and conform to the [Agent Skills specification](https://agentskills.io/specification) — an open standard that works across agents.
Agent sees the name and description of every installed Skill, but only loads the full content when relevant to the current task. This makes skills context-efficient: you can install many without degrading Agent's output.
## Pre-defined Skills
Replit ships with pre-defined skills available from the **Use a skill** picker in chat and from the new-project starting-point picker. These skills work in every project without installation. For the full catalog, partner skills, and how to install them, see the [Skills directory](/features/agent/skills-directory).
To add a pre-defined skill, open the **Use a skill** picker from the chat input and select a skill, or simply ask Agent to load the skill.
## Skill scope
Skills can be scoped at different levels:
| Scope | Availability | Where it lives |
| - | - | - |
| **Project-level** | Specific to one project | Versioned with your files in `/.agents/skills` |
| **Workspace-level** | Available to everyone in your workspace | Managed centrally in Workspace Settings |
For workspace-level skills, see [Agent Customization](/features/agent/agent-customization) to set up workspace skills and custom instructions for your team.
## Create a custom Skill
Create a custom Skill when you want reusable instructions in your Workspace library.
In a shared Workspace, you can set Workspace member access while creating the Skill
and update it later. Who can manage Skills depends on your plan — see
[Agent Customization](/features/agent/agent-customization).
Workspace member access policies are:
| Policy | Access |
| - | - |
| **Required** | Always on and cannot be turned off |
| **Available** | Optional and off by default; members must turn on the Skill to use it |
| **No access** | Hidden from members |
Open **Settings** > **Customization** > **Skills** in the Workspace.
Select **Add**, then select **Write a skill**.
A custom Skill includes:
* **Name**: Identifies the Skill in the Workspace library.
* **Description**: Explains when Agent should use the Skill.
* **Instructions**: Defines the steps Agent should follow.
A new Skill starts as **Private**, so only you and Workspace admins can use it.
Select the **Sharing** control, then set one of the policies above for **Members
in workspace**.
Review the details, then select **Create skill**.
## Share project Skills
In a shared Workspace, you can update member access after the Skill exists.
Create a custom Skill with the steps above, or select an existing Skill in
**Settings** > **Customization** > **Skills**.
To save a project Skill to your Workspace, open **Agent Skills** > **Project skills** in your project. Select **Save to workspace**, enter a name, then select **Save**.
On the Skill card in the Workspace library, open the options menu, then select **Share...**.
In the **Share skill** dialog, select one of the policies above for **Members in
workspace**. Your selection applies immediately; there is no separate
confirmation action.
## Import Skills from GitHub
Add Skills from a public GitHub repository, folder, or file URL.
In Agent, select **+** > **Use a skill** to open **Workspace Skills**.
Paste a public GitHub repository, folder, or file URL, then select **Preview
skills**. The preview checks file structure only. It does not load Skill
instructions or descriptions.
Review the detected Skills, select the ones to import, then select **Import**. The button shows the number of Skills you selected, such as **Import 36 skills**.
The example above uses the public
[mattpocock/skills](https://github.com/mattpocock/skills) repository.
Each import is limited to 50 Skills, 3,500 files, or 200 MiB. Private repositories aren't supported.
Imported repositories appear under the **GitHub** filter on the **Skills** tab.
## How Agent loads skills
Agent reads the metadata (name and description) of every installed skill on every chat. The full body of a skill loads only when Agent determines the skill is relevant to the current task. This keeps skill content out of the context window until needed.
Installed skills persist in your project across Agent sessions and can be committed to version control for team sharing.
## 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
* [Agent Customization](/features/agent/agent-customization) — Make skills and custom instructions available across your whole workspace
* [Skills directory](/features/agent/skills-directory) — Browse skills built by Replit and our partners
* [Use Agent Skills](/build/use-agent-skills) — Hands-on guide for using skills in chat or installing them in a project
* [Agent skills](/learn/agent-skills) — When and how to use skills effectively
* [Agent Skills specification](https://agentskills.io/specification) — Open standard for writing skills