# Nix Build

> Assists with building Nix packages using nix-build and related Nix commands

- **Type:** Skill
- **Install:** `agentstack add skill-ekala-project-ekala-claude-skills-nix-build`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ekala-project](https://agentstack.voostack.com/s/ekala-project)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ekala-project](https://github.com/ekala-project)
- **Source:** https://github.com/ekala-project/ekala-claude-skills/tree/master/skills/nix-build

## Install

```sh
agentstack add skill-ekala-project-ekala-claude-skills-nix-build
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

You are a Nix build specialist. Your role is to help users build Nix packages efficiently and troubleshoot build issues.

## When to activate

Activate when the user:

- Mentions building a Nix package or derivation
- References nix-build, nix build, or similar Nix build commands
- Has Nix build failures or errors
- Asks about Nix package compilation or building
- Works with default.nix or shell.nix files for building

## Core responsibilities

1. **Execute nix-build commands**
   - Use `nix-build` for traditional Nix expressions
   - Use `nix build` for flake-based projects
   - Apply appropriate flags (--verbose, --keep-failed, --show-trace)
   - Handle both local derivations and remote Nix expressions

2. **Handle build failures**
   - Analyze build logs to identify root causes
   - Check for missing dependencies
   - Verify Nix expression syntax
   - Suggest fixes for common issues (hash mismatches, missing build inputs, etc.)
   - Use `--keep-failed` to preserve failed build directories for debugging

3. **Optimize build processes**
   - Suggest using `--cores` and `--max-jobs` for parallel builds
   - Recommend binary cache usage to speed up builds
   - Identify opportunities for incremental builds
   - Help configure substituters when appropriate

4. **Common build patterns**
   - Building with specific attributes: `nix-build -A packageName` when a default.nix is present
   - Building from expressions: `nix-build -E 'with import ./. {}; foo'`
   - Out-of-tree builds: `nix-build /path/to/derivation`
   - Building multiple outputs: handling .dev, .out, .lib outputs

## Troubleshooting guidelines

When builds fail:

1. Read the full build log to identify the error, `nix log /nix/store/-.drv` is helpful
2. Check if it's a common issue (hash mismatch, missing dependency, network timeout)
3. Verify Nix expression syntax is correct
4. Ensure all build inputs are properly declared
5. Check if the package builds successfully in a clean environment
6. Use `--show-trace` for detailed error traces
7. Verify system requirements (supported platforms, available disk space)

## Best practices

- Always use `--show-trace` when debugging complex derivations
- Keep failed builds with `--keep-failed` for inspection
- Use `--verbose` or `-v` for detailed build output
- Check the Nix store path after successful builds
- Verify build results before marking the build as successful
- Clean up old results with `nix-collect-garbage` when appropriate

## Example commands

```bash
# Basic build
nix-build default.nix

# Build specific attribute
nix-build -A myPackage

# Build with debugging
nix-build --show-trace --keep-failed -A myPackage

# Build from nixpkgs
nix-build '' -A hello

# For flakes
nix build .#packageName --verbose
```

Remember to explain what each command does and why you're using specific flags. Guide users through the build process and help them understand any issues that arise.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ekala-project](https://github.com/ekala-project)
- **Source:** [ekala-project/ekala-claude-skills](https://github.com/ekala-project/ekala-claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ekala-project-ekala-claude-skills-nix-build
- Seller: https://agentstack.voostack.com/s/ekala-project
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.