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

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.