CtrlK
BlogDocsLog inGet started
Tessl Logo

nix-profile-manager

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

80

1.42x
Quality

78%

Does it follow best practices?

Impact

74%

1.42x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./nix-profile-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill: executable Nix commands cover install/list/remove/upgrade/search/registry workflows with a clear general workflow and a useful troubleshooting section. Deep material is appropriately delegated to four real, accurately described reference files. Only minor tightening is possible (some section overlap and repeated command examples).

DimensionReasoningScore

Conciseness

The body is efficient and command-focused, but contains trimmable redundancy: the 'Packages vs. Flakes' section overlaps 'Flakes', the General Workflow repeats the search/add commands from Essential Commands, and 'Core Concepts' re-explains flake basics that also live in references/flakes.md. Not a 5 because not every token earns its place; not a 3 because padding is minor, not pervasive.

4 / 5

Actionability

Commands are fully executable and copy-paste ready, e.g. `nix profile add --profile "$AGENT_PROFILE" "nixpkgs#git"`, `nix search nixpkgs python3 --json | jq '.[].pname'`, and concrete troubleshooting checks (`echo $PATH`, `ls -la $AGENT_PROFILE`). Specific examples cover the common cases (install, list, remove, upgrade, registry add), so this fits the top anchor rather than the minor-gaps anchor at 4.

5 / 5

Workflow Clarity

The General Workflow gives a clear sequence (resolve profile path -> search -> add -> use) with a checkpoint ('If not defined, ask the user which profile to use!!') and the Troubleshooting section provides error-recovery guidance. A 4 rather than 5 because there is no explicit verify-after-install step before 'Just use it!'; not a 3 because checkpoints and error-recovery feedback are present.

4 / 5

Progressive Disclosure

The body is an overview with essential commands only, and it points to four real one-level-deep references (references/flakes.md, package-search.md, profile-internals.md, registry.md), each existing on disk and accurately summarized in the References section. This matches the clear-overview anchor, not the 4 anchor, since navigation is easy and nothing that belongs in a reference is inlined.

5 / 5

Total

18

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly and specifically states what the skill does with strong, distinctive Nix-domain triggers and negligible conflict risk. Its main weakness is the absence of any 'Use when...' trigger guidance, which caps completeness, and slightly thin keyword variants. Adding an explicit trigger clause would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions Nix, nix profile, flakes, or wants to install tools/packages without sudo or system-wide changes.'

Broaden keyword coverage with natural variants users actually say: 'nix profile', 'add/install packages with Nix', 'nixpkgs', 'nix-env'.

Mention the remaining core capabilities (removing/upgrading packages, pinning versions) to round out the action list.

DimensionReasoningScore

Specificity

Names the domain ('manage local Nix profiles') and several concrete actions ('installing tools and dependencies', 'profile management, package searching, and registry configuration', 'flakes'). Not a 5 because coverage has minor gaps (remove/upgrade operations and version pinning are not mentioned); well above the 1-2-action anchor at 3.

4 / 5

Completeness

It has a clear 'what' (managing local Nix profiles for installing tools/deps, covering flakes, searching, registry) but no 'Use when...' clause or equivalent explicit trigger guidance, only a weak implication via 'for agents'. Per the judging guideline, a missing explicit trigger clause caps completeness at 3; the 'what' is far too concrete for the vague anchors at 1-2.

3 / 5

Trigger Term Quality

Good natural keyword coverage within the domain: 'Nix', 'profiles', 'flakes', 'installing tools', 'package searching', 'registry'. Missing a few natural terms users would say, such as 'nix profile', 'add package', or 'nix-env', so it fits the good-coverage anchor at 4 rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (local Nix profile management) with distinct Nix-specific triggers ('Nix profiles', 'flakes', 'registry configuration'), making it unlikely to fire for the wrong skill. This matches the clear-niche/minimal-conflict anchor at 5; not 4 since no meaningful overlap with other skills' triggers is apparent.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
YPares/agent-skills
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.