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.
Package Validation
All package changes must pass three validation steps:
1. Evaluation Check
Verify Nix expression evaluates correctly:
nix-instantiate -A <package-name>
Expected: /nix/store/abc123...-package-1.0.0.drv
For non-derivations:
nix-instantiate --eval -A <attribute>
2. Build Check
Verify package builds successfully:
nix-build -A <package-name>
Expected: result symlink to /nix/store/xyz789...-package-1.0.0
Inspect results:
ls -la result/
./result/bin/example --version
ldd result/lib/libexample.so
3. Format Check
Ensure code follows formatting standards:
nix fmt <path-to-file>
Format all modified files:
git diff --name-only '*.nix' | xargs -I {} nix fmt {}
Checking Dependencies
Verify dependencies exist before porting:
# 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
# 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 fmtrun on all edited files - No
meta.maintainersormeta.teams - TODO comments for missing dependencies
Advanced Validation
Check closure size:
nix-store -q --tree $(nix-build -A example --no-out-link)
Check runtime dependencies:
nix-store -q --references $(nix-build -A example --no-out-link)
Rebuild from scratch:
nix-build -A example --rebuild
Reproducibility check:
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: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | 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: 319k | 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: 319k | Updated | Claude CodeCodex | Verified | Install |