The VeriWorkly ATS Engine action scores a resume in a workflow and fails the step when the readiness score drops below min-score. Keep your resume in a repository and check it on every push.

The step runs the published command line with npx, at the engine version in the version input. It installs the PDF and DOCX readers (pdf-parse, pdfjs-dist, mammoth) alongside the engine, so a PDF or Word resume works with nothing set up. It has no dependencies of its own and is not part of either npm package. No AI model is involved in the score.

Usage

- uses: actions/checkout@v5
- uses: VeriWorkly/ats-engine/action@main
  with:
    resume: resume.pdf
    job: jobs/backend-engineer.txt # optional
    min-score: 80 # optional

Inputs

The action has no input for --job-url or --ai. For those, run the command line in a run step.

Outputs

The outputs are written before the step fails on min-score, so a later step can read them with if: always().

Job summary

Unless summary is false, the run's job summary shows:

• the readiness score, the job match when there is a posting, and the minimum with whether it was met;
• each failed check with its severity, finding and fix, or a line saying every check passed;
• each job requirement and its status;
• the missing keywords, and the missing soft skills, which weigh less;
• the advice, labelled as not scored;
• a footer naming the engine version.

Security notes

Resume and posting text is untrusted input, and a resume can say anything. The action treats it that way.

• Inputs reach the script as environment variables and are never pasted into a command line, so a file name cannot inject shell code. Paths are resolved to absolute paths before the command runs outside your repository.
• Text from the resume or posting is shown in the job summary as text. Each table cell is cut to one line of 300 characters, HTML characters are encoded so no tag survives, and Markdown characters are escaped. Colons, @ and the dot after www are written as entities, so an address in a resume does not become a link.
• Line breaks in a message are encoded, so an input or a file name cannot end a workflow command and start another. The command's own warnings, which can quote the resume, are passed on with workflow commands stopped under a random token.
• version must be a version or a dist-tag (letters, digits, ., _ and -), and min-score a number from 0 to 100, or the step fails at once.

Examples

A complete workflow. It checks the resume whenever it or the posting changes:

name: Resume check

on:
  push:
    paths:
      - resume.pdf
      - jobs/**
  pull_request:

jobs:
  ats:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: VeriWorkly/ats-engine/action@main
        with:
          resume: resume.pdf
          job: jobs/backend-engineer.txt
          min-score: 80
          region: US

Using the outputs in a later step. Give the action step an id, and use if: always() so the step runs when the score is below the minimum. The action writes its outputs before it fails the step on min-score:

name: Resume report

on: [push]

jobs:
  ats:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5

      - id: ats
        uses: VeriWorkly/ats-engine/action@main
        with:
          resume: resume.pdf
          job: jobs/backend-engineer.txt
          min-score: 80

      - name: Show the result
        if: always()
        env:
          SCORE: ${{ steps.ats.outputs.score }}
          JOB_MATCH: ${{ steps.ats.outputs.job-match }}
          FAILED: ${{ steps.ats.outputs.failed-checks }}
        run: |
          echo "Readiness: $SCORE"
          echo "Job match: $JOB_MATCH"
          echo "$FAILED" | jq -r '.[] | "\(.severity): \(.evidence)"'

      - name: Keep the full report
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: ats-report
          path: ${{ steps.ats.outputs.report }}

The example passes outputs to run through env instead of pasting them into the script, for the same reason the action does: failed-checks holds text from the resume.