tessleng/tile-creator
Create tessl tiles with docs, rules, and skills.
97
Quality
97%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
skills-format.mdreferences/
Skills Format
Skills are procedural workflows that guide agents through complex tasks.
When creating skills:
- Consider installing and using the
skill-creatorskill. You can install as follows:
tessl i github:anthropics/skills --skill skill-creator- After creating a skill and ensuring proper tile packaging, make sure you review and improve quality if needed. You can review by running:
tessl skill review < path-to-folder-containing-SKILL.md >Structure
skills/
└── my-skill/
├── SKILL.md # Required
├── scripts/ # Optional executables
├── references/ # Optional detailed docs
└── assets/ # Optional output filesSKILL.md Format
Every skill requires a SKILL.md with YAML frontmatter:
---
name: my-skill-name
description: What this skill does. Use when [specific triggers].
---
# Skill Title
Instructions and guidance...Frontmatter Fields
| Field | Required | Description |
|---|---|---|
name | Yes | Lowercase, hyphens only |
description | Yes | What it does + when to use it |
allowed-tools | No | Space-delimited string of tool identifiers (e.g. "Read Write Bash Grep"). Do not convert to a YAML list, comma-separated string, or rename this field. |
Writing Good Descriptions
The description triggers skill activation. Be specific:
Good:
description: Database migration helper for creating and managing schema changes. Use when creating migrations, altering tables, or managing database versions.Bad:
description: Helps with databases.Bundled Resources
scripts/
Executable code for deterministic operations:
scripts/
├── validate.py
├── generate.sh
└── deploy.jsreferences/
Detailed documentation loaded on-demand:
references/
├── api-spec.md
├── schema.md
└── examples.mdassets/
Files used in output (templates, images):
assets/
├── template.html
├── logo.png
└── boilerplate/tile.json Configuration
{
"skills": {
"my-skill": { "path": "skills/my-skill/SKILL.md" }
}
}Example SKILL.md
---
name: deploy-staging
description: Deploy application to staging environment. Use when deploying to staging, testing deployments, or preparing releases.
---
# Deploy to Staging
## Prerequisites
- AWS CLI configured
- Docker installed
- Access to staging cluster
## Deployment Steps
1. Build the Docker image:
```bash
docker build -t app:staging .-
Push to registry:
docker push registry.example.com/app:staging -
Update deployment:
kubectl apply -f k8s/staging/ -
Verify deployment:
kubectl rollout status deployment/app -n staging
Rollback
If issues occur:
kubectl rollout undo deployment/app -n staging## CLI Commands
**Create a new skill:**
```bash
tessl skill new --name my-skill --description "Description" --path ./my-skillValidate a skill:
tessl skill lint ./my-skillReview skill quality:
tessl skill review ./my-skillInstall with Tessl CLI
npx tessl i tessleng/tile-creator@1.1.2