ekala-project/corepkgs / .agents/skills/validation
validation
VerifiedValidate a package change before committing. Use after editing any Nix expression — covers the evaluation, build, and format checks, reading common eval and build errors, and the full pre-commit checklist.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.9 KB |
SKILL.md
View on GitHub---
name: validation
description: Validate a package change before committing. Use after editing any Nix expression — covers the evaluation, build, and format checks, reading common eval and build errors, and the full pre-commit checklist.
---
# Package Validation
All package changes must pass three validation steps:
## 1. Evaluation Check
Verify Nix expression evaluates correctly:
```bash
nix-instantiate -A <package-name>
```
**Expected:** `/nix/store/abc123...-package-1.0.0.drv`
**For non-derivations:**
```bash
nix-instantiate --eval -A <attribute>
```
## 2. Build Check
Verify package builds successfully:
```bash
nix-build -A <package-name>
```
**Expected:** `result` symlink to `/nix/store/xyz789...-package-1.0.0`
**Inspect results:**
```bash
ls -la result/
./result/bin/example --version
ldd result/lib/libexample.so
```
## 3. Format Check
Ensure code follows formatting standards:
```bash
nix fmt <path-to-file>
```
**Format all modified files:**
```bash
git diff --name-only '*.nix' | xargs -I {} nix fmt {}
```
## Checking Dependencies
**Verify dependencies exist before porting:**
```bash
# Single dependency
nix-instantiate -A zlib
# Multiple dependencies
for dep in acl lzo cmocka zlib zstd; do
echo -n "$dep: "
nix-instantiate -A $dep >/dev/null 2>&1 && echo "✓" || echo "✗"
done
```
**DO NOT** search `top-level.nix` with grep. Packages in `pkgs/` and `pkgs-many/` are auto-registered.
## Common Errors
### Evaluation Errors
**Missing dependency:**
```
error: attribute 'somelib' missing
```
Port the dependency or add TODO comment.
**Syntax error:**
```
error: syntax error, unexpected ')'
```
Fix the syntax in the Nix expression.
### Build Errors
**Missing build tool:**
```
error: Program 'pkg-config' not found
```
Add to `nativeBuildInputs`.
**Missing library:**
```
/nix/store/.../bin/ld: cannot find -lz
```
Add to `buildInputs`.
**Test failures:**
Tests are disabled by default. Investigate or keep disabled.
## Complete Validation Workflow
```bash
# Validate a package
PACKAGE="example"
# 1. Evaluate
nix-instantiate -A $PACKAGE
# 2. Build
nix-build -A $PACKAGE
# 3. Test result
./result/bin/$PACKAGE --version
# 4. Format
nix fmt pkgs/$PACKAGE/default.nix
```
## Validation Checklist
- [ ] `nix-instantiate -A <package>` succeeds
- [ ] `nix-build -A <package>` succeeds
- [ ] Built binary/library works
- [ ] All dependencies verified with `nix-instantiate`
- [ ] `nix fmt` run on all edited files
- [ ] No `meta.maintainers` or `meta.teams`
- [ ] TODO comments for missing dependencies
## Advanced Validation
**Check closure size:**
```bash
nix-store -q --tree $(nix-build -A example --no-out-link)
```
**Check runtime dependencies:**
```bash
nix-store -q --references $(nix-build -A example --no-out-link)
```
**Rebuild from scratch:**
```bash
nix-build -A example --rebuild
```
**Reproducibility check:**
```bash
nix-build -A example --check
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |