> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/skills/skillevaluator/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/skills/skillevaluator/_mcp/server.

# Bring Skill Evaluation to Your Repository

> Evaluate changed skills automatically with reusable GitHub and GitLab CI configurations.

Bring SkillEvaluator to the repository where your team builds skills. Choose
your skill folders and get results automatically when skills change.

No evaluation code to write. No scanner installations to manage. The shared
container brings the Tier 1 runtime to your CI runner, including SkillSpector
for specialized skill security scanning.

## How it works

```mermaid
flowchart TD
    repo["Skill changes"] --> runtime["CI runs SkillEvaluator<br />with SkillSpector"]
    runtime --> report["Results and reports"]
    classDef step fill:#f3f9e8,stroke:#76b900,color:#1f2b16,stroke-width:2px
    class repo,runtime,report step
```

The job reads your skills, checks the changes, and saves a report. It does not
require copying SkillEvaluator or SkillSpector source code into your repository.

#### [GitHub Actions](/skills/skillevaluator/github-actions)

Use the guided CLI or copy a workflow to check skills in pull requests, with optional hosted reports and comments.

#### [GitLab CI/CD](/skills/skillevaluator/gitlab-ci)

Include the reusable job in your pipeline to evaluate changed skills in merge requests and download the report.

## Copy a template

No local installation is required for the template route. Both platforms' templates
live in the public NVIDIA/SkillEvaluator repository. Open the file, copy the
filled-in version, and set your skill folders and score threshold.

| Your platform | Ready-to-use template                                                                                                  | Put it in your repository                                        |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| GitHub        | [skill-checks.yml](https://github.com/NVIDIA/SkillEvaluator/blob/main/ci/bundles/0.7.2/skill-checks.yml)               | `.github/workflows/skill-checks.yml`                             |
| GitLab        | [gitlab-skill-checks.yml](https://github.com/NVIDIA/SkillEvaluator/blob/main/ci/bundles/0.7.2/gitlab-skill-checks.yml) | `.gitlab-ci.yml`, or merge into your existing root configuration |

The [ready-to-use templates](https://github.com/NVIDIA/SkillEvaluator/tree/main/ci/bundles/0.7.2)
include the scan workflows and optional GitHub publisher, with reviewed workflow
and image versions already filled in. Open a file and use GitHub's **Raw** view
to copy its full contents. The [template catalog](https://github.com/NVIDIA/SkillEvaluator/blob/main/ci/templates/README.md)
explains customization and optional LLM checks.

## What you get

* **Automatic checks:** evaluate changed skills in pull requests or merge requests; run the configured collection on the default branch.
* **Quality and security:** run Tier 1 checks, including SkillSpector security scanning, without adding evaluator code to the repository.
* **Control:** choose skill directories and a minimum quality score; the job fails when required checks fail or cannot complete.
* **Results you can inspect:** see a concise outcome in CI and download the detailed HTML, JSON, Markdown and SARIF reports.

![Example report table showing a failed skill with a quality score of 98.2](/skills/skillevaluator/_fern-files/_img/77c006735e57d00fe906d37d294b34a7e16c1bce354441872a5cf05abcc54333.webp)

Browse [report, log and PR comment examples](https://github.com/NVIDIA/SkillEvaluator/blob/main/ci/examples/README.md)
in the public repository. No demo-repository access is needed.

> **Note**
>
> The released CI image runs Tier 1, including SkillSpector. It does not run
> Tier 2 or Tier 3. GitHub and GitLab use the same scanner image with
> platform-specific workflow files.

## Other CI systems

The container contains the same evaluator runtime, and the CLI can also run in
other CI systems. The [CI integration guide](/skills/skillevaluator/ci-integration) covers the CLI,
exit codes and report formats. The GitHub and GitLab integrations above have
separate platform-specific configurations; another platform needs its own
integration and validation.