SKILL.mdを自動的にレビューするGitHubアクションは、プルリクエストで変更され、結果がPRコメントとして投稿します。

このアクションは、Tessl Review を実行し、**Tessl API トークンが必要です。 GitHub リポジトリの秘密として保存し、例えば TESSL_TOKEN]] で渡します。 レビューは、Tessl CLI 0.90.0 以降が必要です。このアクションはデフォルトでインストールされます。

レビューは1つのTesslのワークスペースに対して実行されます。 CLI は、リポジトリに tessl.json がワークスペースにリンクされているとき、またはトークンが正確に 1 つを見ることができます。 組織のアカウントで、通常はいくつか表示されるトークン — [workspace]] の入力が必要です。チェックは、一度設定するまでリクエストを失敗します。

使用法

[.github/workflows/skill-review.ymlでリポジトリにこのワークフローを追加します。

SKILL.mdファイルを変更する任意のPRは、自動レビューコメントを取得します。 トークンが複数のワークスペースを見ることができる場合は、[workspace: your-workspace — [tessl workspace list]] で名前を表示します。

入力

| 入力 | 説明 | デフォルト | お問い合わせ | [`workspace` | タスクワークスペース名またはIDレビューが反して実行されます([[`tessl workspace list`]参照)。 CLI がリンクされた `tessl から解決するように設定解除します.

Tessl Skill Review Action

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

This action runs Tessl Review and needs a Tessl API token. Store it as a GitHub repository secret, for example TESSL_TOKEN, and pass it with the tessl-token input. Reviews need Tessl CLI 0.90.0 or later, which the action installs by default.

Reviews run against one Tessl workspace. The CLI picks it for you when the repository has a tessl.json linked to a workspace, or when your token can see exactly one. A token that can see several — usual for an organisation account — needs the workspace input, and the check fails asking for it until you set one.

Usage

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
        with:
          tessl-token: ${{ secrets.TESSL_TOKEN }}

Any PR that modifies a SKILL.md file will get an automated review comment. If your token can see more than one workspace, add workspace: your-workspace — tessl workspace list shows the names.

Inputs

Setting a quality gate

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

- uses: tesslio/skill-review@main
  with:
    tessl-token: ${{ secrets.TESSL_TOKEN }}
    fail-threshold: 70

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

How it works

1. Detects which SKILL.md files were changed in the PR
2. Installs the Tessl CLI
3. Runs tessl review run quality on each changed skill
4. Posts (or updates) a review comment on the PR — with the assessment and any validation issues up front — and writes a job summary
5. Optionally fails the check if any score is below the threshold

Comment behavior