Convex-Dev/convex / .claude/skills/build-convex
build-convex
VerifiedBuild the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.4 KB |
SKILL.md
View on GitHub---
name: build-convex
description: Build the Convex project from source. Use when a contributor wants to compile, test, or package Convex.
disable-model-invocation: true
allowed-tools: Bash
argument-hint: "[module]"
---
# Build Convex
Build the Convex Maven project. Requires Java 21+ (JDK 25 recommended). The
checked-in wrapper supplies the pinned Maven version.
Run every command from the repository root — that is already the working
directory, so do not `cd` anywhere first. Use `./mvnw` on Unix-like shells or
`.\mvnw.cmd` in PowerShell so the build uses the pinned Maven version.
Parse `$ARGUMENTS` for a **module** name (any argument starting `convex-`),
e.g. `convex-core`.
## Fast incremental build
The default when no arguments are given:
```bash
./mvnw -B -T1C test
```
## Build a single module
```bash
./mvnw -B -T1C test -pl <module> -am
```
`-am` also builds the modules that one depends on.
## Final verification
Use a clean, sequential build before claiming work is done:
```bash
./mvnw -B clean verify
```
Use `install` only when another local project needs the fresh artifacts: it
copies them into `~/.m2`.
For a single module's tests:
```bash
./mvnw -B -T1C test -pl <module> -am
```
Report the result — success or failure — and any errors, concisely. On failure,
quote the first real compilation or test error rather than the Maven summary.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |