nix-profile-manager

Name: nix-profile-manager
Rating: 66 (1 reviews)
Author: YPares

tessl i github:YPares/agent-skills --skill nix-profile-manager

github.com/YPares/agent-skills

Expert guidance for agents to manage local Nix profiles for installing tools and dependencies. Covers flakes, profile management, package searching, and registry configuration.

Review Score

66%

Validation Score

13/16

Implementation Score

73%

Activation Score

40%

SKILL.md

Review

Evals

Generated

4 days ago

Warnings & errors only

Criteria	Score
description_trigger_hint	Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...')
metadata_version	'metadata' field is not a dictionary
license_field	'license' field is missing

Overall Assessment

This is a solid skill with excellent actionability - all commands are executable and well-documented. The main weaknesses are some conceptual explanations that Claude doesn't need (what flakes and profiles are) and missing validation steps in the workflow (e.g., verifying installation succeeded before using the tool).

Suggestions

Remove or significantly trim the 'Core Concepts' section explaining what profiles and flakes are - Claude already knows these concepts
Add a validation step after installation in the workflow, such as `which <tool>` or `<tool> --version` to confirm the binary is accessible
Add guidance on handling concurrent profile access since the skill mentions locking isn't automatic but doesn't explain what to do about it

Dimension	Score	Reasoning
Conciseness	2/3	Generally efficient but includes some unnecessary explanations like defining what profiles and flakes are conceptually, which Claude already knows. The 'Core Concepts' section could be trimmed significantly.
Actionability	3/3	Provides fully executable bash commands throughout with concrete examples. Commands are copy-paste ready with clear syntax like `nix profile add --profile "$AGENT_PROFILE" "nixpkgs#git"`.
Workflow Clarity	2/3	The 'General Workflow' section provides a clear sequence, but lacks validation checkpoints. No verification step after installation to confirm the package works, and the profile locking warning doesn't include how to handle concurrent access.
Progressive Disclosure	3/3	Well-structured with clear sections progressing from Quick Start to Core Concepts to Commands. References section provides one-level-deep links to detailed materials (flakes.md, package-search.md, etc.) with clear descriptions.

Overall Assessment

The description identifies a clear technical niche (Nix profile management) which provides good distinctiveness, but lacks explicit trigger guidance and uses category-level terms rather than concrete actions. The absence of a 'Use when...' clause significantly weakens its utility for skill selection.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when the user mentions Nix, nixpkgs, flakes, nix-env, or needs to install development tools via Nix'
Replace category terms with concrete actions: 'Install packages via nix profile, search nixpkgs, configure flake registries, manage development environments'
Include common user phrases like 'install with nix', 'nix shell', 'add package to profile' to improve trigger term coverage

Dimension	Score	Reasoning
Specificity	2/3	Names the domain (Nix profiles) and lists some actions (flakes, profile management, package searching, registry configuration), but these are categories rather than concrete actions like 'install packages' or 'update profiles'.
Completeness	1/3	Describes what it does (guidance for Nix profiles) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.
Trigger Term Quality	2/3	Includes relevant keywords like 'Nix', 'flakes', 'profile management', 'package searching', but misses common user terms like 'nix-env', 'nixpkgs', 'install package', or 'nix shell'.
Distinctiveness Conflict Risk	3/3	Nix is a specific technology with distinct terminology; unlikely to conflict with other skills due to the specialized nature of Nix package management.