Skip to main content
Agent Skills help your team reuse guidance from your repositories instead of repeating the same instructions across multiple agents. You can browse available skills from connected repositories, preview a skill before adding it, manage all registered skills in one place, and assign the right skills to the right agents. Overcut is compatible with the open Agent Skills spec, so you can bring any existing SKILL.md-formatted skills straight from your connected code repositories or from a skills marketplace. No rewriting or re-authoring required.
Skills are discovered from repositories that are already connected to your workspace. If you do not see the repository you need, start with the Repositories guide.

​
What Agent Skills are

A skill is a reusable set of instructions stored in one of your connected repositories. After you add a skill to a project, it becomes part of that project’s shared toolkit and can be assigned to agents when needed. Skills are useful when you want to:
  • Reuse team standards without copying the same instructions into multiple agents
  • Keep guidance close to the repository or codebase it supports
  • Give agents focused expertise for specific frameworks, services, or workflows
  • Maintain one project-level list of approved skills for your team

​
Discover skills from connected repositories

Overcut shows available skills from repositories that are connected to your workspace. This gives your team a single place to find reusable guidance that is already packaged in the repositories you use every day.
The Skills page with a left rail of project skills and a selected PR Description skill showing General, Source, Metadata, and SKILL.md Content sections.
1

Open the Skills area

In your project, go to Skills to view the project-level list of registered skills and discover new ones.
2

Open Add Skills from Repository

Select Add Skill to open Add Skills from Repository, where you can browse skills from your connected repositories.
3

Choose a connected repository

In Search, use Repository to choose the repository that contains the skills you want to use.
4

Scan for repository skills

Select Scan for skills. Overcut checks the selected repository and shows discovered skills in Results.
5

Select one or more skills

Use Select Skills to choose the skills you want to add. You can add one skill or multiple skills in the same flow.
Overcut hides skills that are already added to the project, so you cannot add duplicates. If every discovered skill is already in the project, the Results area tells you so.
If your team manages many repositories, skills discovery helps you find reusable guidance without manually searching each repository.

​
Preview a skill before adding it

Before you register a skill in the project, you can preview its instructions to confirm that it matches your team’s needs. When you open a skill preview, you can review:
  • The skill name
  • The connected repository it comes from
  • The repository path for the skill
  • The skill instructions from SKILL.md
When you select multiple skills, Skill Details shows one skill at a time and indicates how many are selected, so you can review each skill without losing your selection. Previewing skills helps you validate each skill’s purpose, scope, and wording before making it available to agents.

​
Add one or more skills to the project

Once you find skills you want to use, add them to the project’s Skills area. This creates a shared project-level list that your team can review and manage over time.
1

Review selected skills

Use Skill Details to confirm the selected skills are the right fit for the project before you add them.
2

Add the selected skills

Select Add Skill when one skill is selected. When more than one skill is selected, the primary action changes to Add N Skills.
3

Review the project Skills list

After you add multiple skills, Overcut returns you to the project Skills list. Use the list to review the saved skills and check where each skill comes from, including its connected repository, source path, and any pinned reference if one is shown.
The project-level Skills list gives your team a central place to review which reusable instructions are available for agents in that project.

​
Enable, disable, and remove skills

You can manage each project skill without editing the source repository directly.

Enable

Keep a skill available for assignment to agents when your team wants to use it.

Disable

Temporarily prevent a skill from being assigned while keeping it in the project list for later use.

Remove

Delete a skill from the project’s Skills area when it is no longer needed.
Disabling a skill is useful when you want to pause its availability without losing track of it. Removing a skill is better when you want to clean up the project list entirely.
Only enabled project skills are available when you assign skills to an agent.

​
Assign skills to agents

After a skill has been added to the project and left enabled, you can assign it to individual agents. This lets each agent use the specific guidance it needs without overloading every agent with the same instructions.
1

Open the agent settings

Go to the agent you want to update in your project configuration.
2

Select skills for that agent

In the agent’s Skills section, choose from the enabled project skills.
3

Remove skills when needs change

Update the agent later to remove skills that are no longer relevant.
This workflow works well alongside your agent’s base role and other configuration. To learn more about agent setup, see Base Agent Types.