Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt

Use this file to discover all available pages before exploring further.

You can create a Skill in two ways depending on what you need:
PathUse when
Create from UIYou only need a single SKILL.md (no supporting files). Fastest way to get started.
Upload using CLIYour skill has multiple assets — references/, scripts/, assets/, etc. — or you want to author the skill alongside your codebase and publish via CI/CD.
Both paths produce the same artifact: a versioned Skill stored under a Repository and addressable by its FQN (e.g. agent-skill:my-tenant/my-skills/analytics-helper:1).

​
Prerequisites

Before creating a skill, make sure you have:
  • A Repository with at least one storage integration configured. The skill bundle is stored in this repository’s blob storage. See Repository for setup.
  • For the CLI path: the TrueFoundry CLI installed and authenticated. See CLI Setup.

​
Option 1 — Create from the UI

The UI flow is the fastest way to publish a single-file skill. The Gateway uses the SKILL.md content you author here as the entire skill bundle.
1

Open the Skills Registry

Navigate to Agents → Skills in the left sidebar and click Create New Skill. Choose Create from UI in the menu.
Create New Skill menu showing Create from UI and Upload using CLI options
2

Fill in the basic fields

FieldDescription
NameLowercase letters, digits, hyphens. 1–64 chars. Cannot contain anthropic or claude.
RepositoryThe Repository where this skill version is stored.
DescriptionA short, action-oriented description. The agent uses this to decide whether the skill is relevant. 1–1024 chars.
3

Author the SKILL.md body

The SKILL.md editor is a Markdown editor. The Gateway automatically prepends the YAML frontmatter (name and description) from the fields above, so you only write the body — the procedure the agent should follow.
# Analytics Helper Skill

## Querying Tables

To run a query against the warehouse, call …

## Common Aggregations

…
The full SKILL.md (frontmatter + body) is capped at 20 KB / 20,000 characters. The UI warns you when content exceeds about 5,000 tokens (~17,500 characters) so you have room to grow before hitting the hard limit.
4

Save the version

Click Save to create the first version. The skill appears in the Skills Registry table with v1. To create a new version later, open the skill and click New Version in the version list.
Skill detail drawer showing version history, FQN, files preview, and usage code snippets

​
Option 2 — Upload using the CLI

Use the CLI when your skill has supporting files. The CLI reads your local folder, validates SKILL.md, and registers a new version.
1

Lay out the skill folder on disk

Create a folder rooted at SKILL.md. Add any supporting assets next to it.
analytics-helper/
├── SKILL.md
├── references/
│   ├── sales-tables.md
│   ├── customer-tables.md
│   └── product-tables.md
└── scripts/
    ├── query.py
    └── format.py
The SKILL.md at the root must start with YAML frontmatter containing name and description:
SKILL.md
---
name: analytics-helper
description: How to query the analytics warehouse. Use when the user asks for sales, usage, or cost numbers.
---

# Analytics Helper Skill

## Querying Tables
...
The CLI validates this file before uploading.
2

Run tfy upload skill

From the parent directory of your skill folder:
tfy upload skill \
  --repository my-skills \
  --dir ./analytics-helper
FlagDescription
--repositoryThe Repository to publish into. The repository must already exist.
--dir / -dPath to the local skill root directory. Defaults to the current directory. Must contain SKILL.md.
The CLI:
  1. Reads SKILL.md and validates the frontmatter (name, description, length limits).
  2. Stages a new artifact version, uploads the skill files, and registers the version on the control plane.
On success you’ll see:
Uploaded skill version successfully.
The version appears in the Skills Registry UI with its FQN — e.g. agent-skill:my-tenant/my-skills/analytics-helper:1.
3

(Optional) Download a Skill to inspect it

To pull a skill’s files back to disk — useful for editing an existing skill, or auditing what’s mounted into an agent — use tfy download skill:
mkdir -p ./skills
tfy download skill \
  --fqn agent-skill:my-tenant/my-skills/analytics-helper:1 \
  --dir ./skills
This pulls the full skill bundle (SKILL.md + all supporting files) under ./skills/analytics-helper/.See Register Skill for the full CLI and tfy apply manifest reference.

​
Attach the Skill to an Agent

Once a skill version exists, it can be mounted into any TrueFoundry Agent. Open the Agent Playground, click + next to Skills in the sidebar, and select the skill version you just created.
Skills selector in the Agent Playground listing available skills with per-skill version dropdowns
See Use Skills in Agents for the Preload SKILL.md option and per-request overrides.