CI workflow (jnMetaCode/superpowers-zh)

The CI workflow from jnMetaCode/superpowers-zh, explained and optimized by Latchkey.

CI health: C - fair

Point runs-on at Latchkey and get run de-duplication, job timeouts, self-healing for flaky steps, and up to 58% lower cost, applied automatically.

Grade your own workflow free or run it on Latchkey →

Source: jnMetaCode/superpowers-zh.github/workflows/ci.ymlLicense MITView source

What it does

This is the CI workflow from the jnMetaCode/superpowers-zh repository, a real project running GitHub Actions. It is shown here with attribution under its MIT license.

Below, Latchkey shows a faster, safer version produced by its optimization engine.

The workflow

workflow (.yml)

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  validate:
    name: Validate skills and structure
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Count skills
        run: |
          TOTAL=$(ls -d skills/*/ 2>/dev/null | wc -l)
          echo "Total skills: $TOTAL"
          ls -d skills/*/

      - name: Validate skill frontmatter
        run: |
          ERRORS=0
          for dir in skills/*/; do
            SKILL_FILE="${dir}SKILL.md"
            if [ ! -f "$SKILL_FILE" ]; then
              echo "::error::Missing SKILL.md in $dir"
              ERRORS=$((ERRORS + 1))
              continue
            fi

            # Check frontmatter exists
            if ! head -1 "$SKILL_FILE" | grep -q '^---'; then
              echo "::error file=$SKILL_FILE::Missing frontmatter"
              ERRORS=$((ERRORS + 1))
              continue
            fi

            # Check required fields
            FRONTMATTER=$(sed -n '1,/^---$/p' "$SKILL_FILE" | tail -n +2)
            for field in name description; do
              if ! echo "$FRONTMATTER" | grep -q "^${field}:"; then
                echo "::error file=$SKILL_FILE::Missing required field: $field"
                ERRORS=$((ERRORS + 1))
              fi
            done
          done

          if [ $ERRORS -gt 0 ]; then
            echo "::error::$ERRORS validation error(s) found"
            exit 1
          fi
          echo "All skills validated successfully"

      - name: Check package.json
        run: |
          node -e "
            const pkg = JSON.parse(require('fs').readFileSync('package.json', 'utf8'));
            const required = ['name', 'version', 'description', 'license'];
            const missing = required.filter(f => !pkg[f]);
            if (missing.length) {
              console.error('Missing package.json fields:', missing.join(', '));
              process.exit(1);
            }
            console.log('package.json OK:', pkg.name, 'v' + pkg.version);
          "

      - name: Validate install script
        run: node bin/superpowers-zh.js --help

The same workflow, on Latchkey

Removes redundant runs and caps runaway jobs. Added and changed lines are highlighted.

name: CI
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  validate:
    timeout-minutes: 30
    name: Validate skills and structure
    runs-on: latchkey-small
    steps:
      - uses: actions/checkout@v4
 
      - name: Count skills
        run: |
          TOTAL=$(ls -d skills/*/ 2>/dev/null | wc -l)
          echo "Total skills: $TOTAL"
          ls -d skills/*/
 
      - name: Validate skill frontmatter
        run: |
          ERRORS=0
          for dir in skills/*/; do
            SKILL_FILE="${dir}SKILL.md"
            if [ ! -f "$SKILL_FILE" ]; then
              echo "::error::Missing SKILL.md in $dir"
              ERRORS=$((ERRORS + 1))
              continue
            fi
 
            # Check frontmatter exists
            if ! head -1 "$SKILL_FILE" | grep -q '^---'; then
              echo "::error file=$SKILL_FILE::Missing frontmatter"
              ERRORS=$((ERRORS + 1))
              continue
            fi
 
            # Check required fields
            FRONTMATTER=$(sed -n '1,/^---$/p' "$SKILL_FILE" | tail -n +2)
            for field in name description; do
              if ! echo "$FRONTMATTER" | grep -q "^${field}:"; then
                echo "::error file=$SKILL_FILE::Missing required field: $field"
                ERRORS=$((ERRORS + 1))
              fi
            done
          done
 
          if [ $ERRORS -gt 0 ]; then
            echo "::error::$ERRORS validation error(s) found"
            exit 1
          fi
          echo "All skills validated successfully"
 
      - name: Check package.json
        run: |
          node -e "
            const pkg = JSON.parse(require('fs').readFileSync('package.json', 'utf8'));
            const required = ['name', 'version', 'description', 'license'];
            const missing = required.filter(f => !pkg[f]);
            if (missing.length) {
              console.error('Missing package.json fields:', missing.join(', '));
              process.exit(1);
            }
            console.log('package.json OK:', pkg.name, 'v' + pkg.version);
          "
 
      - name: Validate install script
        run: node bin/superpowers-zh.js --help

What changed

Run on Latchkey managed runners with one line (runs-on), which apply the fixes below automatically and self-heal transient failures. This example uses latchkey-small; pick the runner size that fits the job.
Cancel superseded runs when a branch or PR gets a newer push.
Add a job timeout so a hung step cannot burn hours of runner time.

This workflow runs 1 job per trigger. On Latchkey the same minutes cost up to 58% less than GitHub-hosted, with zero queue time.

Actions used in this workflow

actions/checkout