---
title: "Semgrep Repository Scan: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-semgrep/
description: "Plan and execute language-scoped Semgrep scans with explicit partial, failed and uncovered scan states."
---

# Semgrep Repository Scan: review, setup & limitations · Undominated.ai

> Plan and execute language-scoped Semgrep scans with explicit partial, failed and uncovered scan states.

[← Explore all skills](/skills/)

SECURITY / trailofbits

# Semgrep Repository Scan

Plan and execute language-scoped Semgrep scans with explicit partial, failed and uncovered scan states.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/trailofbits/skills/tree/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 4 linked sources
 Publisher trailofbits
 Licence [CC-BY-SA-4.0 ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE)
 Revision 8e54050ae63c
 [Read what was—and wasn’t—checked ↓](#review)

“Plan and execute language-scoped Semgrep scans with explicit partial, failed and uncovered scan states.”

 [trailofbits · upstream description ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The scan skill treats the user's request to scan as not enough approval, and run-scans.sh is what puts --metrics=off on every generated command.
- The separate slash-command workflow is documented as skipping that approval gate because the scan does not use --autofix.
- The inspected helper constructs argument arrays, forces metrics off, records target byte limits and counts files actually scanned.
- Combine selected registry and third-party rulesets with bounded language scope

### A good fit for

 - Running an approved Semgrep ruleset list over a local tree with telemetry turned off.
- Refusing a hand-written semgrep command when the script is what keeps metrics and include filters in place.
- Combine selected registry and third-party rulesets with bounded language scope
- Review findings alongside oversized-file, parse-error and no-file coverage gaps

### Weigh up before choosing

 - OSS Semgrep, as this file describes it, cannot track data flow across files. Third-party rules are cloned into the output directory and then deleted.
- run-scans.sh avoids bash 4 features so it can run on macOS bash 3.2. It still needs the Semgrep CLI, which the skill does not install.
- This review did not execute the resource.
- Semgrep edition, parser support and rule licensing differ; third-party rulesets require their own review.
- The helper can retain usable output from partial rule-compilation failures; inspect partial, failed and skipped states instead of treating artifact existence as success.
- The scan helper deletes its own raw output directory on reuse. Use a dedicated directory and preserve prior evidence first.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/static-analysis/skills/semgrep/SKILL.md
- plugins/static-analysis/skills/semgrep/scripts/run-scans.sh
- plugins/static-analysis/skills/semgrep/workflows/scan-workflow.md
- LICENSE
- README.md

### Our findings

 - Semgrep phones home unless --metrics=off is set. The script hard-codes that flag and also clones third-party rule repositories into the output directory.
- The interactive skill requires an explicit yes after the plan. The original request, silence, and questions are listed as not approval. The /static-analysis:semgrep-scan workflow does not stop for that gate.
- It does not autofix. OSS mode does not track taint across files, and a ruleset whose clone or scan failed has to be reported rather than omitted.
- The inspected helper constructs argument arrays, forces metrics off, records target byte limits and counts files actually scanned.
- Its status logic distinguishes missing artifacts, partial compilation and known-zero file coverage; selected helper branches were reviewed without running scans.

### Not established by this review

 - The resource was not executed and its tools were not called.
- Semgrep was not installed or run, and no ruleset repository was cloned.
- No skill execution, authenticated service operation, or outcome benchmark was performed.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md)
 - Check out trailofbits/skills at 8e54050ae63c2f62224c35b1616efe71865b4777 and install the complete static-analysis plugin through the publisher-supported host workflow, retaining sibling agents, workflows, scripts and references.
- Install Semgrep, jq and git; review proposed languages, rulesets and scope before running.
- Keep scans.json with JSON/SARIF outputs and pass scan status to the merge step; metrics are disabled and autofix is outside this workflow.

### Before you start

 - Semgrep
- jq, git and bash
- A dedicated output directory

### Compatibility

A supported full-plugin host; Workflow orchestration requires the Workflow capability named in the definition

### Local instructions; runtime access depends on the workflow

 - Read project source, fetch rule repositories, execute Semgrep, replace the run raw-output directory and write scan artifacts; Pro features may need credentials.

### Cost model

Instructions are free; agent usage and separately licensed tools can incur charges.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Pinned skill definition ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep/SKILL.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep/SKILL.md Supports: summary, whySelected, bestFor, limitations, install, access, review
- [Publisher repository and installation guidance ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md Supports: install
- [CC-BY-SA-4.0 licence ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE Supports: license
- [plugins/static-analysis/skills/semgrep/scripts/run-scans.sh ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep/scripts/run-scans.sh) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/static-analysis/skills/semgrep/scripts/run-scans.sh Supports: review, limitations, access, install

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Burp Project Parser ↗ Extract and search captured Burp traffic while distinguishing empty results from parser startup failures.](/skills/trailofbits-burpsuite-project-parser/)[### C and C++ Security Review ↗ Coordinate scoped native C/C++ security review and assemble findings with an explicit coverage ledger.](/skills/trailofbits-c-review/)[### DWARF Debug Information ↗ Inspect DWARF symbols, types, line tables and address mappings using tool-specific commands.](/skills/trailofbits-dwarf-expert/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
