Promote or claim a skill you have created

Have you authored a skill in GitHub and want to promote it using Tessl? Tessl allows you to take a skill from a local repository or GitHub repository, and generate the tile.json, which is essential for Tessl Tiles and Skills. Once imported, you will publish the tile to make it available, publicly or privately, to your teams. The following section discusses organization of your skills and how to publish them. Additionally if you have authored a Tile on GitHub that appears in Tessl, there is a section on claiming that skill in Tessl.

Prerequisites

• Tessl installed

• Tessl logged in

• Skill code available locally

• Access to a workspace

Mapping and importing your skills into Tessl tiles

If you've authored a number of skills and documents to help your agents, you can logically group the related files together and create individual skill tiles in Tessl. For example:

• If you're developing a "data migration" skill, place all the files related to that skill and documentation in a single folder or repository. This would be a single tile.

• Similarly if you've built a skill for "building a front end", that might contain best practices and design skills you would group them together into its own tile, create the tile.json,by running the import command, then lint, review, eval and publish the skill to your workplace.

Anti-patterns

To avoid performance issues and confusion of your agents, avoid throwing in the kitchen sink! Make your skill purpose built, providing the information for specific tasks.

Clone the Repository

Clone your repository locally.

Create a tile.json

• Create a tile.json (metadata describing it) by running the following command, with your workspace and folder location values:

  tessl skill import ./<directory with SKILL.md> --workspace <myworkspace>

• You can create an eval file in /eval or request one through the web interface. More on this coming soon!

Improve your skill with Lint, Review, and Evaluate your Skill

Review your Skill against best practices

Before publishing, validate your skill structure and contents:

tessl skill lint ./my-skill

This command checks:

• SKILL.md format and structure

• Required frontmatter fields (name, description)

• Conformance to the Agent Skills specification

• Markdown validity

To optimize your skill, run the following:

tessl skill review --optimize ./my-skill

Fix any errors before proceeding.

Evaluate quality using Scenarios

Once you've built your skill the final step before publishing is to create scenarios your skill can be evaluated against. The following document illustrates how you would accomplish this:

• Evaluate skill quality using scenarios

Set up GitHub Action to publish to Tessl's Registry

The following steps introduce the GitHub action to your repository to publish your tile automatically.

Using the GitHub action will automatically link your tile to the repository, and all skills we previously indexed in the repository will be hidden and redirected to the tiles. See Tessl's setup-tessl GitHub action for additional options and information.

1

Create your workflow

Create your workflow file .github/workflows/tessl-publish.yml. Here's an example action for auto-publishing.

2

Create an API Key

Log into Tessl on web UI, then navigate to API keys. Create a new API key. Copy the value as it will only be shown once.

3

Add your API Key as a Repository Secret

In GitHub, navigate to your repo Settings, select Secrets and variables, under actions find New Repository Secret. Provide the name: TESSL_TOKEN and the value is the Tessl API key you procured in the earlier step.

4

Run your workflow

Kick off your workflow by running the relevant trigger, or manually triggering from the UI if you enabled that in your workflow definition.

Claim a Tessl Skill

Found a skill in Tessl that is created/indexed from your Skill/GitHub repository of skills? You'll want to claim ownership and disable indexing by Tessl. To do this, you will:

• Recreate the skill in your workspace by importing it locally, update the workspace in tile.json.

• Use the GitHub action to publish , which will manage the Skill and ensure changes to the repo are reflected in your Tessl workspace and not reindexed by Tessl.

If you accidentally use the CLI to publish a skill to your workspace, and the skill was already indexed by Tessl in the Tessl workspace, you would find two versions, in two different workspaces, when searching for that skill. You can contact Tessl support to claim your tile and address the duplicate. Be sure to set up the GitHub action as part of this.