Create tessl tiles with docs, rules, and skills.
Does it follow best practices?
Evaluation — 97%
↑ 1.98xAgent success when using this tile
Validation for skill structure
{
"context": "Tests whether the agent correctly normalizes Python package names in the purl format, uses API markers in documentation, and configures the CLI command with proper workspace flag matching.",
"type": "weighted_checklist",
"checklist": [
{
"name": "Purl normalization",
"description": "The describes field normalizes the Python package name: underscores converted to hyphens and lowercase (smart_data_loader becomes smart-data-loader in the purl)",
"max_score": 12
},
{
"name": "Purl ecosystem",
"description": "The describes field uses 'pkg:pypi/' as the ecosystem prefix (not pkg:pip/ or pkg:python/)",
"max_score": 10
},
{
"name": "Purl includes version",
"description": "The describes field includes @2.4.0 version suffix",
"max_score": 8
},
{
"name": "Docs required with describes",
"description": "tile.json contains both 'describes' and 'docs' fields (docs is required when describes is set)",
"max_score": 10
},
{
"name": "API markers used",
"description": "At least 3 API elements in the documentation use the '{ .api }' marker in their heading",
"max_score": 10
},
{
"name": "Index.md entry point",
"description": "Documentation has an index.md file that serves as the entry point with links to other pages",
"max_score": 8
},
{
"name": "CLI workspace matches",
"description": "In setup-notes.md, the CLI command has --workspace value matching the prefix of --name (ds-team)",
"max_score": 8
},
{
"name": "CLI describes flag",
"description": "In setup-notes.md, the CLI command includes --describes with a purl string",
"max_score": 8
},
{
"name": "Progressive disclosure",
"description": "Documentation is split across at least 2 files beyond index.md (e.g., separate files for different modules or topics)",
"max_score": 8
},
{
"name": "Tile name lowercase hyphens",
"description": "tile.json name uses only lowercase letters and hyphens (no underscores): ds-team/pypi-smart-data-loader",
"max_score": 8
},
{
"name": "Semver version",
"description": "tile.json version field is a valid semver string (2.4.0)",
"max_score": 5
},
{
"name": "Private by default",
"description": "tile.json either omits the 'private' field (defaults to true) or explicitly sets it to true",
"max_score": 5
}
]
}