Tessl Workflow Installer Skill

Implements Tessl skill review GitHub Actions workflows through an interactive configuration wizard.

Quick Start

# Navigate to your repository
cd /path/to/your/repo

# In Claude Code, invoke:
# "Use tessl-workflow-installer to set up the workflow"

What This Skill Does

1. Validates your environment (git repo, GitHub remote)
2. Detects existing workflows and offers updates
3. Configures based on your preferences (single vs two-workflow)
4. Creates workflow files with smart defaults
5. Guides you through git operations and testing

Workflow Architectures

Single-Workflow

• For internal repositories with trusted contributors
• One workflow file, direct PR commenting
• Simpler setup

Two-Workflow

• For public repositories with external contributors
• Separates review from commenting for security
• Uses workflow_run trigger

Features

✅ Score diff tracking (🔺 🔻 ➡️) ✅ Persistent cache in git ✅ Dimension-level comparisons ✅ Auto-commit cache updates ✅ Version detection and migration ✅ Smart defaults with customization

Examples

New Repository:

User: "Add Tessl workflow"
Skill: Validates repo → Asks architecture → Uses defaults → Creates files → Done!

Update Existing v2:

User: "Update my Tessl workflow"
Skill: Detects v2 → Offers v4 upgrade → Shows new features → Updates files

Migrate Architectures:

User: "Migrate to single-workflow"
Skill: Detects two-workflow → Confirms migration → Removes comment workflow → Done!

After Installation

1. Add TESSL_API_KEY to GitHub Secrets (required)
2. Test manually using workflow_dispatch
3. Test with PR to see score diff in action

Troubleshooting

See the skill's embedded testing instructions for common issues and solutions.