Implements Tessl skill review GitHub Actions workflows in your repository through an interactive, configuration-first wizard.
Does it follow best practices?
Evaluation — 99%
↑ 1.24xAgent success when using this tile
Validation for skill structure
After setup is complete, provide these testing instructions to the user.
Test the workflow immediately without making code changes:
# Get repository info for URL construction
REPO_URL=$(git remote get-url origin | sed 's/\.git$//' | sed 's|git@github.com:|https://github.com/|')
echo "Test the workflow now:"
echo "1. Go to: ${REPO_URL}/actions/workflows/tessl-skill-review.yml"
echo "2. Click 'Run workflow' button"
echo "3. Select branch: {{TARGET_BRANCH}}"
echo "4. Click 'Run workflow'"
echo ""
echo "What to verify:"
echo "✅ Workflow runs without errors"
echo "✅ Review scores appear in workflow summary"
echo "✅ Cache file was created/updated at: {{CACHE_FILE}}"Test the complete PR workflow with score diff tracking:
1. Create test branch:
git checkout -b test/skill-review-setup
2. Modify a SKILL.md file (add a word to the description):
echo "Updated for testing" >> path/to/SKILL.md
3. Commit and push:
git add path/to/SKILL.md
git commit -m "test: trigger skill review workflow"
git push -u origin test/skill-review-setup
4. Create Pull Request on GitHub
5. Wait for workflow to run (check Actions tab)
6. Verify PR comment appears with:
✅ Review results table
✅ Score percentages
✅ Detailed evaluations in expandable sections
7. Merge the PR to {{TARGET_BRANCH}}
8. Verify cache auto-committed:
git pull origin {{TARGET_BRANCH}}
git log --oneline -5
# Look for: "chore: update skill review cache [skip ci]"
9. Create another PR with same skill
✅ Score diff indicators appear (🔺 🔻 ➡️)
✅ Previous vs Current scores shownSuccessful Setup:
Common Issues:
| Issue | Solution |
|---|---|
| Workflow fails immediately | Check that TESSL_API_KEY is set in GitHub Secrets |
| No PR comment appears | Verify pull-requests: write permission in workflow |
| Cache not committing | Check that contents: write permission is set |
| Score diff not showing | Ensure cache file exists and has previous run data |
Install with Tessl CLI
npx tessl i tessl-labs/tessl-workflow-installerevals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5