2. Copy skill into tile directory

cp -r /

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

4. Validate

tessl tile lint


If lint fails, see [Common Lint Errors](#common-lint-errors) below, fix issues, then re-run lint.

## Tile Structure

```text
<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.

converting-skill-to-tessl-tile

Converting Skills to Tessl Tiles

Prerequisites

Quick Start