> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/stackai-tools/skill-management/create-skill.md).

# Create Skill

Save reusable instructions as a skill so agents can apply the same process consistently. A useful description explains when the agent should choose the skill.

## Before you start

You need permission to create skills in the organization.

## Create a reusable skill

1. Enter a unique **Name**, a **Description** of when to use the skill, and its **Instructions** in Markdown.
2. Select the **Actions** the skill needs. Add supporting files through the selected **File Source** when instructions alone are insufficient.
3. Use [Validate Skill](https://docs.stackai.com/stackai-tools/skill-management/validate-skill.md) to check the proposed content. Resolve blocking errors before creating the skill.
4. Run **Create Skill** and retain **Skill ID**. Inspect the stored instructions and actions before attaching the skill to an agent.

**Result:** The new skill is created at version 1 and can be referenced by its skill ID.

## Behavior and troubleshooting

Creating a skill does not attach it to an agent. Allowed action references do not provide service credentials; required connections and permissions still need to be configured. Review **Normalization** when files are supplied to see how the imported content was adjusted.

## Inputs

| Field                   | Parameter      | Description                                                                                   |
| ----------------------- | -------------- | --------------------------------------------------------------------------------------------- |
| Name (required)         | `name`         | The skill's name. Must be unique in your organization.                                        |
| Description (required)  | `description`  | What the skill does and when to use it. Agents read this to decide whether to load the skill. |
| Instructions (required) | `instructions` | The skill's instructions, in markdown.                                                        |
| Actions                 | `actions`      | Actions this skill is allowed to use. Pick from the live catalog.                             |
| File Source             | `file_source`  | Choose how all optional supporting files are provided.                                        |
| Supporting Files        | `text_files`   | Optional text files, each with a bundle name and inline content.                              |
| Supporting Files        | `url_files`    | Optional files fetched from URLs, each with its bundle name.                                  |

## Outputs

| Field         | Parameter       | Description                                                    |
| ------------- | --------------- | -------------------------------------------------------------- |
| Summary       | `summary`       | One-line summary of what was created.                          |
| Skill ID      | `skill_id`      | The new skill's unique identifier.                             |
| Name          | `name`          | The published skill name.                                      |
| Description   | `description`   | The published description.                                     |
| Version       | `version`       | The published version number, always 1 for a create.           |
| Actions       | `actions`       | Action refs stored with the version.                           |
| Instructions  | `instructions`  | The stored SKILL.md body.                                      |
| Frontmatter   | `frontmatter`   | The stored SKILL.md frontmatter.                               |
| Files         | `files`         | The stored file manifest (metadata only).                      |
| Normalization | `normalization` | What the import process changed; only set when files are sent. |

## Related guidance

[Skill Instructions, Files, and Action References](https://docs.stackai.com/technical-reference/models-agents-and-skills/skill-instructions-files-and-action-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/stackai-tools/skill-management/create-skill.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
