CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/tile-creator

Create tessl tiles with docs, rules, and skills.

Does it follow best practices?

Evaluation97%

1.98x

Agent success when using this tile

Validation for skill structure

Overview
Skills
Evals
Files

tile-json.mdreferences/

tile.json Configuration

The manifest file that defines a tile's metadata and content locations.

Required Fields

FieldTypeDescription
namestringTile identifier: workspace/tile-name
versionstringSemantic version (e.g., 1.0.0)
summarystringBrief description for discovery

Optional Fields

FieldTypeDescription
privatebooleantrue (default) = workspace-only, false = public
docsstringPath to docs entry point (e.g., docs/index.md)
describesstringPURL of external package this documents
steeringobjectMap of rule names to rule files
skillsobjectMap of skill names to SKILL.md paths

Validation Rules

  • At least one of docs, steering, or skills required
  • If describes is set, docs is required
  • Names must be lowercase with hyphens only

PURL Format (describes field)

When documenting a software package, use the Package URL (PURL) format:

pkg:<ecosystem>/<name>@<version>
EcosystemExample
npmpkg:npm/openai@6.9.1
pypipkg:pypi/requests@2.31.0
mavenpkg:maven/org.apache.commons/commons-lang3@3.14.0
nugetpkg:nuget/Newtonsoft.Json@13.0.3

Note: Normalize package names (e.g., PyPI uses lowercase with hyphens: emoji_logger becomes pkg:pypi/emoji-logger@1.0.0)

Examples

Documentation tile for npm package:

{
  "name": "tessl/npm-openai",
  "version": "6.9.1",
  "docs": "docs/index.md",
  "describes": "pkg:npm/openai@6.9.1",
  "summary": "OpenAI TypeScript library",
  "private": false
}

Private rules tile:

{
  "name": "myorg/code-standards",
  "version": "0.1.0",
  "summary": "Team coding standards",
  "private": true,
  "steering": {
    "naming": { "rules": "rules/naming.md" },
    "error-handling": { "rules": "rules/error-handling.md" }
  }
}

Skills tile:

{
  "name": "myorg/deploy-tools",
  "version": "1.0.0",
  "summary": "Deployment automation skills",
  "skills": {
    "deploy-staging": { "path": "skills/deploy-staging/SKILL.md" },
    "deploy-prod": { "path": "skills/deploy-prod/SKILL.md" }
  }
}

Mixed tile (docs + rules + skills):

{
  "name": "local/project-context",
  "version": "0.1.0",
  "summary": "Project documentation and tools",
  "private": true,
  "docs": "docs/index.md",
  "steering": {
    "code-style": { "rules": "rules/code-style.md" }
  },
  "skills": {
    "test-runner": { "path": "skills/test-runner/SKILL.md" }
  }
}

Install with Tessl CLI

npx tessl i tessl-labs/tile-creator

SKILL.md

tile.json