action.yml

# Copyright Advanced Micro Devices, Inc.
#
# SPDX-License-Identifier: MIT

name: skillscope
description: >-
  Run one skillscope command against the calling repository, from this
  action's own checkout.

# Pin the tag you want to run, the same way you pin the reusable workflow:
#
#   - uses: amd/skillscope@v0.1.3
#
# The Python in that checkout is the harness. There is no second version to
# resolve, and nothing here fetches a different ref.

inputs:
  command:
    description: 'The skillscope subcommand: structural, routing, behavioral, select, list-skills, template.'
    required: true
  args:
    description: "Further arguments for the subcommand, shell-quoted."
    required: false
    default: ""
  skills:
    description: >-
      Globs naming the directories that are skills, comma-separated. Passed
      through to the harness as --skills-dir. Default: ./*, every directory
      at the repo root.
    required: false
    default: ""
  repo:
    description: "Root of the repo to test. Default: the workspace."
    required: false
    default: "."
  stdin:
    description: "A file to feed the command on stdin (`select --changed` reads one)."
    required: false
    default: ""
  python-version:
    description: "Python for the harness. Default: 3.12."
    required: false
    default: "3.12"
  setup-python:
    description: "Set up Python. Turn off on a runner where it is already pinned."
    required: false
    default: "true"
  install-claude:
    description: >-
      Install Node and the claude CLI. Needed by `routing` and `behavioral`,
      pointless for `structural` and `select`.
    required: false
    default: "false"
  node-version:
    description: "Node for the claude CLI. Default: 20."
    required: false
    default: "20"

outputs:
  version:
    description: "The harness version that ran, read from the checkout it ran from."
    value: ${{ steps.skillscope.outputs.version }}
  stdout:
    description: >-
      The last line of the command's output. For `select` that is the plan
      JSON; other commands report through the step summary.
    value: ${{ steps.skillscope.outputs.stdout }}

runs:
  using: composite
  steps:
    - name: Set up Python
      if: inputs.setup-python == 'true'
      uses: actions/setup-python@v5
      with:
        python-version: ${{ inputs.python-version }}

    - name: Set up uv
      uses: astral-sh/setup-uv@v7

    - name: Set up Node
      if: inputs.install-claude == 'true'
      uses: actions/setup-node@v4
      with:
        node-version: ${{ inputs.node-version }}

    # Python, not bash: a composite action must name a shell on every `run:`, so
    # it cannot fall back to the runner's default the way a workflow step can.
    # A leg lands on whatever platform its skill asked for, and a self-hosted
    # Windows runner need not have bash -- naming it here is what turns that
    # into `bash: command not found` on a step that is really about npm.
    - name: Install the claude CLI
      if: inputs.install-claude == 'true'
      shell: python
      run: |
        import shutil
        import subprocess
        import sys

        # `npm` is `npm.cmd` on Windows, and only a PATH lookup finds it.
        npm = shutil.which("npm")
        if npm is None:
            sys.exit(
                "error: npm is not on PATH. The `Set up Node` step before this "
                "one should have put it there."
            )
        sys.exit(
            subprocess.run([npm, "install", "-g", "@anthropic-ai/claude-code"]).returncode
        )

    # One step, in Python, because the same launcher runs on Linux, Windows,
    # and macOS runners and a shell script would need three of itself.
    - name: Run skillscope
      id: skillscope
      shell: python
      env:
        SKILLSCOPE_COMMAND: ${{ inputs.command }}
        SKILLSCOPE_ARGS: ${{ inputs.args }}
        SKILLSCOPE_REPO: ${{ inputs.repo }}
        SKILLSCOPE_SKILLS: ${{ inputs.skills }}
        SKILLSCOPE_STDIN: ${{ inputs.stdin }}
        SKILLSCOPE_ACTION_PATH: ${{ github.action_path }}
      run: |
        import os
        import runpy
        import sys

        launcher = os.path.join(os.environ["SKILLSCOPE_ACTION_PATH"], "bootstrap", "launch.py")
        sys.argv = [launcher]
        runpy.run_path(launcher, run_name="__main__")