Optimize a skill using best practices

The previous section discussed how skill reviews are scored and presented. In this section, let us learn how to auto-generate improvements for those agent skills based on best practices!

TL;DR

The Review capability of Tessl also can suggest fixes and implement them if you accept them. See example below.

Prerequisites

• Tessl installed

• Skill available locally

Usage

Perform a review and automatically generate improvements for your skill:

tessl skill review --optimize ./<path to SKILL.md folder>

• Runs tessl skill review to score your skill

• The option --optimize automatically makes the suggested changes and re-runs the review

  • Runs in a loop until the skill scores 100% or a set number of iterations has passed

  • Prompts the user to accept automated edits to SKILL.md, unless overridden.

Additional flags

• Use the --max-iterations flag to configure the max number of improvement loops - this defaults to 3 and can be set to a maximum of 10.

• Use the --yes (or -y) flag to skip the confirmation prompt and auto-apply the suggested changes:

tessl skill review --optimize --yes ./<path to SKILL.md folder>

This is useful for CI pipelines or batch workflows where you want to apply improvements without manual confirmation.

Example

A summary of changes will be provided, alongside the improvement score, such as:

You will be prompted to accept the changes, unless you have used the additional option to automatically do so.

How to integrate it into your workflow

1. Search for a skill or create your own.

2. Download the skill locally.

3. Use the Tessl CLI to review and optionally ask it to fix it via the --optimize option.

4. Convert to a Tessl tile by importing it, if it is not already in a Tessl tile.

5. Optionally, consider running scenario based evaluations.

6. Publish to your workspace to share the skill tile. Create a workspace if it does not exist yet.