validate-skills.yml

# validate-skills.yml — Drop this into your library repo's .github/workflows/
#
# Validates skill files on PRs that touch the skills/ directory.
# Ensures frontmatter is correct, names match paths, and files stay under
# the 500-line limit.

name: Validate Skills

on:
  pull_request:
    paths:
      - 'skills/**'
      - '**/skills/**'

permissions:
  contents: read

jobs:
  validate:
    name: Validate skill files
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
        with:
          persist-credentials: false

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

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

      - name: Find and validate skills
        run: |
          # Find all directories containing SKILL.md files
          SKILLS_DIR=""
          if [ -d "skills" ]; then
            SKILLS_DIR="skills"
          elif [ -d "packages" ]; then
            # Monorepo — find skills/ under packages
            for dir in packages/*/skills; do
              if [ -d "$dir" ]; then
                echo "Validating $dir..."
                intent validate "$dir"
              fi
            done
            exit 0
          fi

          if [ -n "$SKILLS_DIR" ]; then
            intent validate "$SKILLS_DIR"
          else
            echo "No skills/ directory found — skipping validation."
          fi