Prek
Testing & QualityPrek 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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
prekfails with an error about resolving dependencies or security policy, you may be running in a restricted environment where the special-purposegpkgtool is required. Prefix the command withgpkg, for example:gpkg prek run -aorgpkg ./scripts/jj_prek.sh.