> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.meetgail.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.meetgail.com/_mcp/server.

# Run Skill

> Runs a reusable Skill that can write and run code in a private sandbox to handle an open-ended task.

The Run Skill node hands an open-ended task to a Skill: a saved, reusable set of
instructions and helper files kept in your organization's catalog. When it runs,
the Skill works in a private sandbox where it can write and run code to get the
job done, then returns its answer along with any files it produced. Use it when
a step needs real computation or file work that a single prompt cannot cover.

## When to use it

* You need to crunch data mid-run, like totaling a column across an uploaded
  spreadsheet or reconciling two files.
* You want to produce a file, such as a summary report, a CSV, or a formatted
  document, and pass it to a later step.
* You have a task worth packaging once and reusing across many workflows.

## Inputs

| Field       | What it's for                                                                                                                             | Example                                                    |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Skill       | The Skill to run, chosen from your organization's catalog.                                                                                | A "policy summary" Skill                                   |
| Instruction | The task for this particular run, in plain language. This can be pulled from earlier steps, so the same Skill handles different requests. | "Total the premium column and produce a one-page summary." |
| Input Files | Optional files to make available to the Skill, such as a document uploaded at the start of the run.                                       | An uploaded policy schedule                                |

The Skill itself is picked when you build the workflow, not from data at run
time. When you attach input files, the node makes them available to the Skill
inside the sandbox, so write the instruction to point at the uploaded files.

## Outputs

| Field           | What you get back                                                                                                                             |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Generated files | Any files the Skill produced and handed back, in the order it created them. Each can be passed straight into a later step that accepts files. |
| Final text      | The Skill's final written answer once it finishes.                                                                                            |

## Example

An agency uploads a policy schedule as a spreadsheet at the start of a workflow.
A Run Skill node points at a "policy summary" Skill and instructs it to read the
uploaded file, total the premium column, and produce a one-page summary as a
CSV. The Skill does the work in its sandbox and returns the CSV, which flows into
an [Agent](/platform/workflows/node-reference/ai/agent) step that writes a short plain
recap for the account manager.

![The Run Skill node configuration panel, showing the selected Skill, the instruction, and input files.](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/gail.docs.buildwithfern.com/4b3f8d224f0be33bc89f8fedb7876a00bdf4bb5fdd418b2f1cec0a2344f1bf84/docs/pages/platform/workflows/assets/ai-run-skill.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260823%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260823T232857Z&X-Amz-Expires=604800&X-Amz-Signature=d4d3ba9f9ea4a2815f4e22d497b3a513de9a5d3e6ea76ce454465f3e20d759a1&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Files the Skill produces can be passed directly into any later node that
accepts files, so there is no need to rebuild them from the final text. When
you attach input files, tell the Skill to look for them in your instruction.
Run Skill may not be available in every account; if you do not see it in the
builder, it is not turned on for you.

## Related nodes

#### [Agent](/platform/workflows/node-reference/ai/agent)

Hand a prompt to an agent when the task does not need to run code.

#### [Document Analysis](/platform/workflows/node-reference/ai/document-analysis)

Check and read details off uploaded documents.

#### [Create CSV](/platform/workflows/node-reference/files-and-documents/create-csv)

Build a CSV from workflow data without running a Skill.

#### [Check](/platform/workflows/node-reference/logic-and-flow/check)

Turn the result into a single labeled outcome.