A GitHub Action that automatically reviews SKILL.md files changed in a pull request and posts the results as a PR comment.

No authentication required. This action runs tessl skill review locally — no Tessl account or API token needed. The only token used is the GitHub-provided GITHUB_TOKEN for posting PR comments.

Add this workflow to your repository at .github/workflows/skill-review.yml:

name: Tessl Skill Review
on:
  pull_request:
    paths: ['**/SKILL.md']

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: tesslio/skill-review@main

That's it. Any PR that modifies a SKILL.md file will get an automated review comment.

To enforce a minimum skill quality score, set fail-threshold:

- uses: tesslio/skill-review@main
  with:
    fail-threshold: 70

PRs with any skill scoring below 70% will fail the check.

1. Detects which SKILL.md files were changed in the PR
2. Installs the Tessl CLI
3. Runs tessl skill review on each changed skill
4. Posts (or updates) a review comment on the PR with scores and detailed feedback
5. Optionally fails the check if any score is below the threshold

The action posts a single comment per PR. On subsequent pushes, it updates the existing comment rather than creating a new one.

bun install
bun run lint

MIT