> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# GitHub badges

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

<figure><img src="/gitbook-assets/image (19).png" alt=""><figcaption></figcaption></figure>

## 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](/improving-your-skills/reviewing-skills.md).

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](/codifying-and-enforcing/gate-skill-quality-in-ci.md).