> 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/technical-reference/models-agents-and-skills/skill-instructions-files-and-action-references.md).

# Skill Instructions, Files, and Action References

A skill combines instructions with related files and action references. Use it to keep a reusable procedure together rather than copying long instructions between agents.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FGaA0HGPYksl6x3hJ93iD%2FG017.mp4?alt=media&token=ead5b3c6-555d-4786-96e2-915080ba2598>" %}

## Before you begin

Permission to create or update skills and access to any referenced actions.

## Key concepts

| Term            | Definition                                                                                                                                                   |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Skill           | Reusable instructions and supporting resources that guide an agent through a task. It supplies guidance, not provider credentials or additional permissions. |
| Supporting file | A file included with a skill to provide related material. Preserve its path when instructions refer to that file.                                            |
| Connection      | A saved authorization to a particular provider account. An action uses the selected account’s access, subject to StackAI sharing controls.                   |

## Configuration options

| Option             | Purpose                                             | Behavior                                                             |
| ------------------ | --------------------------------------------------- | -------------------------------------------------------------------- |
| Skill instructions | The procedure and guidance packaged in a skill.     | Describe when to use it and what evidence or result is required.     |
| Action reference   | An identifier linking a skill to a tool capability. | The reference does not supply the connection required by the action. |

## Add instructions and resources to a skill

1. Write instructions that define the task, required evidence, and expected result.
2. Add supporting files with relative paths and select valid action references from the catalog.

![Add supporting files to keep the procedure and its reference material together.](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/w7UjE1HUGpxCYCMGistF/assets/g017-g017-02-terminal-dependency.png)

Add supporting files to keep the procedure and its reference material together.

3. Attach the skill to the intended agent and inspect the available tools.

The agent can use the skill’s procedure and included resources.

## Behavior and limitations

Text fields and file-bundle imports are different input modes. A bundle needs the supported root SKILL.md format. File replacement does not imply that omitted files remain. An action reference names a capability; it does not supply credentials or grant permission to a provider.

## Related resources

[Create reusable skills](https://docs.stackai.com/guides-and-quickstarts/agent-builder-and-skills/create-reusable-skills.md)

[Model Settings and Supported Capabilities](https://docs.stackai.com/technical-reference/models-agents-and-skills/model-settings-and-supported-capabilities.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/technical-reference/models-agents-and-skills/skill-instructions-files-and-action-references.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.
