---
metadata:
- name: generator
content: Diplodoc Platform v5.57.3
alternate:
- https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/ai-skills.md
- https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md
- href: en/sourcecraft/operations/ai-skills.md
type: text/markdown
title: Markdown version
- href: ../../llms.txt
type: text/markdown
title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/en/llms.txt
# Using AI skills in SourceCraft
{% note tip %}
This page is about skills in the SourceCraft interface. To learn about skills in the Code Assistant plugin, see [Skills in SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/skills.md).
{% endnote %}
You can automate recurring tasks and extend the functionality of the [chat with Code Assistant](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/code-assistant.md#chat-mode) in the SourceCraft interface using _AI skills_.
An AI skill starts in the chat with Code Assistant and supplies the AI agent with instructions and context specific to the particular task and repository the chat has been opened in.
Instead of providing the AI agent with multi-step instructions each time, describe them once and call them as an AI skill as needed. AI skills also allow you to standardize your workflow within your team and replicate it across different repositories.
For example, you can do the following using AI skills:
* Complete interactive training for SourceCraft users.
* Request help with repository configuration.
* Decompose an [issue](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#issues).
* Summarize issue-related information.
* Gather the context of your actions in the repository for the last few hours.
For more information, see [AI skills in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md).
{% note info %}
Follow these guides to set up skills in the SourceCraft interface. Learn more about the Configuration as Code setup format in [Skill configuration files](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#ai-skills-config).
{% endnote %}
## Running a skill {#run-skill}
Only [system skills](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#system) are immediately available for running in any [repository](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/index.md#repos) by default. To run a [skill from the catalog](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#catalog) or a [public skill](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#public), first [import](#import-skill) it. To run a [custom skill](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#custom), first create it in the repository.
To run a skill:
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the  **Home** tab, under  **Your craftspace**, navigate to  **Repositories**.
1. Select the repository you want to run a skill in.
1. In the panel on the left, click  **Code Assistant Chat**.
You can also run a skill from  **CI/CD** in the  **AI skills** section.
1. Click  in the bottom-right corner of the chat and select the skill you want to run.
{% note tip %}
If you know the command corresponding to the skill, you can also start typing it in the chat beginning with `/`, e.g., `/configs`, and then select the command from the drop-down menu, e.g., `/configs-helper`.
{% endnote %}
1. Click  or press **Enter**.
1. Optionally, if the skill implies any parameters, enter them or select them from the drop-down menu and click **Accept**.
1. Code Assistant may ask you clarifying questions as you go along. Answer them in the chat in natural language.
{% note tip %}
If you change your mind and want to stop Code Assistant, click  **Stop**.
{% endnote %}
Wait for the  **Finished skill scenario** message to appear in the chat.
1. If changes were applied to the repository when executing a skill:
1. In the top-right corner, click **Commit changes**.
1. In the window that opens, configure the procedure for changes:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
## Importing a skill {#import-skill}
You can import a [skill from the catalog](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#catalog) or any [public skill](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#public) into your repository.
{% note warning %}
Imported skills contain instructions for Code Assistant that will be executed within your repository. Make sure to review the contents of these instructions before using a skill.
Note that an imported skill can be modified by its author, which may, in turn, lead to unexpected behavior.
{% endnote %}
### Importing a skill from the catalog {#add-from-catalog}
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. Click  **Browse AI skills** in the top center section.
1. Select the skill you want to import.
You can search by name or keyword and sort skills by command or name.
1. Click  **Import** in the skill card.
The catalog also displays [system skills](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#system) which you cannot import as they are available in any repository by default.
{% note tip %}
To test a skill, click  **Launch**.
{% endnote %}
1. Select the repository you want to import the skill into.
1. Review the skill's instructions and parameters.
1. Optionally, set **Additional instructions for model** and **Launch parameters**.
1. Click **Save**.
1. In the window that opens:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
1. [Test](#run-skill) the skill.
### Importing a public skill {#add-public-skill}
1. In the repository you want to import the skill into, [create](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/add-file-repo.md) a file named [.sourcecraft/ai.yaml](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#ai-yaml) with the following contents:
```yaml
skills:
- source:
repo: /
path: .sourcecraft/skills/
settings:
instructions: |-
inputs:
:
```
Where:
* `source.repo`: Path to the public repository you are importing a skill from, e.g., `examples/skills`.
* `source.path`: Path to the directory housing the skill, e.g., `.sourcecraft/skills/issue-summary`.
* `settings.instructions`: Additional instructions for the agent, e.g., `Return results in English only`.
* `settings.inputs`: Default skill settings, e.g., `config_type: Brach rules`.
1. [Test](#run-skill) the skill.
## Configuring a system skill or imported skill {#configure-skill}
You can configure additional instructions and default parameters for [system](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#system) and [public](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#public) skills, or [skills from the catalog](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md#catalog):
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the  **Home** tab, under  **Your craftspace**, navigate to  **Repositories**.
1. Select the repository you want to configure a skill in.
1. Under  **CI/CD**, navigate to  **AI skills**.
1. Click  next to the skill you want to configure.
1. Set **Additional instructions for model** and **Launch parameters**.
1. Click **Save**.
1. In the window that opens:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
## Creating a custom skill {#add-custom-skill}
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the  **Home** tab, under  **Your craftspace**, navigate to  **Repositories**.
1. Select the repository you want to create a skill in.
1. Under  **CI/CD**, navigate to  **AI skills**.
1. In the top-right corner, click **New AI skill**.
1. In the window that opens, set the following:
* **Name** you are going to see in the SourceCraft interface, e.g., `Issue summary`.
* **Description**, e.g., `Creates a brief summary of the issue. Use for a quick look into large issues or issues with extensive threads of comments`.
* **Launch command**, e.g., `issue-summary`.
* **Description for model**: Text instructions for the agent in [Markdown](https://en.wikipedia.org/wiki/Markdown) markup.
{% note tip %}
For examples of skills, see these repositories: [sourcecraft/ai](https://sourcecraft.dev/sourcecraft/ai) and [examples/skills](https://sourcecraft.dev/examples/skills).
{% endnote %}
1. Optionally, under **Launch parameters**, click  **Add parameter** and configure it:
1. Select the parameter type:
*  **String**.
*  **Choice**. Add possible options for this parameter type.
*  **Boolean**.
1. Enter a name for the parameter.
1. Optionally, select or set the default parameter value.
1. Optionally, enter the parameter description.
1. Specify if this is a required parameter.
To add another parameter, click  **Add parameter**.
{% note info %}
In text instructions for the agent, parameters are specified in `{{ }}` format.
{% endnote %}
1. Click **Save**.
1. In the window that opens:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
1. [Test](#run-skill) the skill.
## Editing a custom skill {#edit-custom-skill}
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the  **Home** tab, under  **Your craftspace**, navigate to  **Repositories**.
1. Select the repository you want to edit a custom skill in.
1. Under  **CI/CD**, navigate to  **AI skills**.
1. Next to the custom skill to edit, click  and select  **Edit**.
1. Edit the custom parameter settings. For more information, see [Creating a custom skill](#add-custom-skill).
1. Click **Save**.
1. In the window that opens:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
## Deleting a custom or imported skill {#remove-skill}
1. Open the SourceCraft [home page](https://sourcecraft.dev).
1. On the  **Home** tab, under  **Your craftspace**, navigate to  **Repositories**.
1. Select the repository you want to delete a skill in.
1. Under  **CI/CD**, navigate to  **AI skills**.
1. Next to the skill to delete, click  and select  **Delete**.
1. In the window that opens:
* In the **Commit message** field, give a comment that will describe the changes you make.
* Under **Commit branch**, select the branch you want to change. Create a new branch as needed.
* Under **After commit action**, select an action to take after saving changes: `Save and create a new change proposal` or `Just save`.
1. Confirm your changes.
#### Useful links {#see-also}
* [AI skills in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md)
* [Chat with Code Assistant in SourceCraft](https://sourcecraft.dev/portal/docs/en/sourcecraft/operations/ca-chat.md)
* [AGENTS.md](https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/agentsmd.md)
* [Slash (/) commands in SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/slash-commands.md)
* [Skills in SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/en/code-assistant/operations/agent/skills.md)