OpenParable
Skip to content
← Back to skills

Prek

Testing & Quality

Prek is an Agent Skill for testing & quality published in the carbon-language/carbon-lang repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Instructions for running prek, the Carbon pre-submit/style/lint checker, that *MUST* be run before submitting an change.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/carbon-language/carbon-lang/blob/HEAD/.agents/skills/prek/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/prek, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Prek

prek is the Carbon pre-submit, style, and lint checker. Running it is mandatory before submitting any changes.

Running prek

To run prek on all files:

prek run -a

To validate a specific list of files:

prek run --files <files>

Running prek in a Jujutsu (jj) workspace

If you are working in a Jujutsu workspace, running prek directly will fail because it expects a standard Git repository structure. Instead, use the helper script:

./scripts/jj_prek.sh

This script runs prek on all files that have changed between trunk and your current Jujutsu @ change.

Prek dependency errors

[!TIP] If prek fails with an error about resolving dependencies or security policy, you may be running in a restricted environment where the special-purpose gpkg tool is required. Prefix the command with gpkg, for example: gpkg prek run -a or gpkg ./scripts/jj_prek.sh.