For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reference/github-badges.md.

GitHub badges

Using GitHub badges is a great way to share your skill and show a score!

Usage

To use a badge, navigate to the registry page of your plugin/skill. If the skill is public, there will be a badge displayed on the right hand side of the page. Use the copy button and place the markdown in your README.MD to display the badge on your GitHub page.

Improving your score

To improve a low score, run tessl review fix ./my-skill --workspace engteam to apply automated improvements. See Check a skill's quality using review.

To gate the score in CI – for example, to fail a pull request when a skill drops below a threshold – use tessl review run with --json and --threshold. See Gate skill quality in CI.