check-skills.yml

# check-skills.yml — Drop this into your library repo's .github/workflows/
#
# Checks for stale intent skills after a release and opens a review PR
# if any skills need attention. The PR body includes a prompt you can
# paste into Claude Code, Cursor, or any coding agent to update them.
#
# Triggers: new release published, or manual workflow_dispatch.
#
# Template variables (replaced by `intent setup`):
#   @tanstack/devtools  — e.g. @tanstack/query

name: Check Skills

on:
  release:
    types: [published]
  workflow_dispatch: {}

permissions:
  contents: read

jobs:
  check:
    name: Check for stale skills
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
        with:
          fetch-depth: 0
          persist-credentials: true # review job pushes a generated branch

      - name: Setup Node
        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
        with:
          node-version: 20

      - name: Install intent
        run: npm install -g @tanstack/intent@0.0.41

      - name: Check staleness
        id: stale
        run: |
          OUTPUT=$(npx @tanstack/intent stale --json 2>&1) || true
          echo "$OUTPUT"

          # Check if any skills need review
          NEEDS_REVIEW=$(echo "$OUTPUT" | node -e "
            const input = require('fs').readFileSync('/dev/stdin','utf8');
            try {
              const reports = JSON.parse(input);
              const stale = reports.flatMap(r =>
                r.skills.filter(s => s.needsReview).map(s => ({ library: r.library, skill: s.name, reasons: s.reasons }))
              );
              if (stale.length > 0) {
                console.log(JSON.stringify(stale));
              }
            } catch {}
          ")

          if [ -z "$NEEDS_REVIEW" ]; then
            echo "has_stale=false" >> "$GITHUB_OUTPUT"
          else
            echo "has_stale=true" >> "$GITHUB_OUTPUT"
            # Escape for multiline GH output
            EOF=$(dd if=/dev/urandom bs=15 count=1 status=none | base64)
            echo "stale_json<<$EOF" >> "$GITHUB_OUTPUT"
            echo "$NEEDS_REVIEW" >> "$GITHUB_OUTPUT"
            echo "$EOF" >> "$GITHUB_OUTPUT"
          fi

      - name: Build summary
        if: steps.stale.outputs.has_stale == 'true'
        id: summary
        run: |
          node -e "
            const stale = JSON.parse(process.env.STALE_JSON);
            const lines = stale.map(s =>
              '- **' + s.skill + '** (' + s.library + '): ' + s.reasons.join(', ')
            );
            const summary = lines.join('\n');

            const prompt = [
              'Review and update the following stale intent skills for @tanstack/devtools:',
              '',
              ...stale.map(s => '- ' + s.skill + ': ' + s.reasons.join(', ')),
              '',
              'For each stale skill:',
              '1. Read the current SKILL.md file',
              '2. Check what changed in the library since the skill was last updated',
              '3. Update the skill content to reflect current APIs and behavior',
              '4. Run \`npx @tanstack/intent validate\` to verify the updated skill',
            ].join('\n');

            // Write outputs
            const fs = require('fs');
            const env = fs.readFileSync(process.env.GITHUB_OUTPUT, 'utf8');
            const eof = require('crypto').randomBytes(15).toString('base64');
            fs.appendFileSync(process.env.GITHUB_OUTPUT,
              'summary<<' + eof + '\n' + summary + '\n' + eof + '\n' +
              'prompt<<' + eof + '\n' + prompt + '\n' + eof + '\n'
            );
          "
        env:
          STALE_JSON: ${{ steps.stale.outputs.stale_json }}

      - name: Open review PR
        if: steps.stale.outputs.has_stale == 'true'
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          VERSION: ${{ github.event.release.tag_name || 'manual' }}
          SUMMARY: ${{ steps.summary.outputs.summary }}
          PROMPT: ${{ steps.summary.outputs.prompt }}
        run: |
          BRANCH="skills/review-${VERSION}"

          git config user.name "github-actions[bot]"
          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
          git checkout -b "$BRANCH"
          git commit --allow-empty -m "chore: review stale skills for ${VERSION}"
          git push origin "$BRANCH"

          {
            printf '%s\n\n' '## Stale Skills Detected'
            printf '%s\n\n' 'The following skills may need updates after the latest release:'
            printf '%s\n\n' "$SUMMARY"
            printf '%s\n\n' '---'
            printf '%s\n\n' '### Update Prompt'
            printf '%s\n\n' 'Paste this into your coding agent (Claude Code, Cursor, etc.):'
            printf '%s\n' '~~~'
            printf '%s\n' "$PROMPT"
            printf '%s\n' '~~~'
          } > pr-body.md

          gh pr create \
            --title "Review stale skills (${VERSION})" \
            --body-file pr-body.md \
            --head "$BRANCH" \
            --base main