converting-skill-to-tessl-tile

Package a standalone skill into a Tessl tile for versioning, distribution, and evaluation. Creates tile manifest, validates directory structure, and ensures skill format compliance. Use when asked to "convert to tile", "package this skill", "create a tessl tile", "wrap skill in tile", or before running evals on a skill not yet in a tile.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Converting Skills to Tessl Tiles

Wrap standalone skills into Tessl tiles to enable versioning, publishing, and evaluation.

Prerequisites

Tessl CLI must be installed. Verify with:

tessl --version

If not installed, visit https://docs.tessl.io/

Quick Start

# 1. Create new tile
tessl tile new <tile-name>

# 2. Copy skill into tile directory
cp -r <skill-folder> <tile-name>/

# 3. Update tile.json to reference the skill (see schema below)

# 4. Validate
tessl tile lint <tile-name>

If lint fails, see Common Lint Errors below, fix issues, then re-run lint.

Tile Structure

<tile-name>/
├── tile.json
└── <skill-name>/
    ├── SKILL.md
    ├── references/   (optional)
    └── scripts/      (optional)

tile.json Schema

{
  "name": "<workspace>/<tile-name>",
  "version": "0.0.1",
  "summary": "Brief description of what this tile provides.",
  "private": true,
  "skills": {
    "<skill-name>": {
      "path": "<skill-name>/SKILL.md"
    }
  }
}

Fields:

name: Format workspace/tile-name (workspace is your tessl username or org)
version: Semantic version
summary: One-line description
private: Set false to make publicly discoverable. Tiles cannot be made private after they are published, so this should be set to false until the user is ready to publish.
skills: Map of skill names to their SKILL.md paths

Multiple Skills

A tile can contain multiple skills:

{
  "name": "myorg/data-tools",
  "version": "1.0.0",
  "summary": "Data processing and visualization skills.",
  "private": false,
  "skills": {
    "csv-processor": {
      "path": "csv-processor/SKILL.md"
    },
    "chart-builder": {
      "path": "chart-builder/SKILL.md"
    }
  }
}

Common Lint Errors

Error	Cause	Fix
`missing SKILL.md`	Path in tile.json doesn't match actual file location	Update `path` to match actual SKILL.md location
`invalid name format`	Name missing workspace prefix	Use format `workspace/tile-name`
`missing frontmatter`	SKILL.md lacks YAML frontmatter	Add `---` delimited frontmatter with `name` and `description`
`missing description`	SKILL.md frontmatter missing description field	Add `description:` to SKILL.md frontmatter
`invalid version`	Version not semver format	Use format like `1.0.0` or `0.0.1`

After fixing errors, re-run: tessl tile lint <tile-name>

Using Tiles

# Install locally for testing
tessl tile install <tile-name>

# Optionally publish to registry
tessl tile publish <tile-name>

Next Steps

After creating a tile, use the creating-eval-scenarios skill to generate evaluation scenarios.

Repository: ericjohnolson/tessl-test
Path: .tessl/tiles/tessl-labs/tessl-skill-eval-scenarios/converting-skill-to-tessl-tile/SKILL.md
Commit: 2a98cc1

Last updated: 7 days ago
First committed: 7 months ago

Also appears in

xomyakus/spec-native-skills

In sync

since Sep 9, 2026

xomyakus/spec-native-skills

In sync

since Sep 9, 2026

tessl-labs/tessl-skill-eval-scenarios

In sync

since Feb 6, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.