Direnv environment management for automatic per-project shell configuration. Use when setting up .envrc files, configuring project-specific environment variables, or integrating direnv with development tools like nix, asdf, pyenv, or nvm.
86
84%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description with strong trigger terms and clear 'Use when' guidance. The main weakness is that the capability description could be more specific about concrete actions (e.g., 'create .envrc files, debug direnv issues, configure allowed directories'). Overall, it effectively distinguishes itself and provides good selection criteria.
Suggestions
Expand the capabilities section with more specific actions like 'create and edit .envrc files, troubleshoot direnv loading issues, configure direnv allowlists'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (direnv environment management) and mentions some actions like 'setting up .envrc files' and 'configuring project-specific environment variables', but doesn't list multiple concrete specific actions like creating, editing, debugging, or validating configurations. | 2 / 3 |
Completeness | Clearly answers both what ('Direnv environment management for automatic per-project shell configuration') and when ('Use when setting up .envrc files, configuring project-specific environment variables, or integrating direnv with development tools'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'direnv', '.envrc files', 'environment variables', 'project-specific', and specific tool integrations (nix, asdf, pyenv, nvm) that users would naturally mention when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Very distinct niche with specific triggers like 'direnv', '.envrc', and the specific tool integrations. Unlikely to conflict with general environment variable or shell configuration skills due to the explicit direnv focus. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a comprehensive, actionable direnv reference with excellent code examples covering many use cases. The main weaknesses are the lack of a clear getting-started workflow and the monolithic structure that could benefit from splitting advanced topics into separate files. The anti-patterns section is valuable for teaching correct usage.
Suggestions
Add a 'Quick Start' section at the top with a numbered workflow: 1) Install direnv, 2) Add shell hook, 3) Create .envrc, 4) Add .envrc.local to .gitignore, 5) Run 'direnv allow'
Move the Setup Commands section to the beginning since it's a prerequisite for using any of the patterns
Consider splitting language-specific patterns and integration patterns into separate reference files (e.g., PYTHON.md, NIX.md) with links from the main skill
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, presenting patterns and code examples without explaining what direnv is or how environment variables work. Every section provides actionable configuration patterns without unnecessary preamble. | 3 / 3 |
Actionability | All examples are copy-paste ready bash/shell configurations. The skill provides complete, executable .envrc snippets for multiple languages and integration scenarios, plus concrete setup commands. | 3 / 3 |
Workflow Clarity | While individual patterns are clear, there's no explicit workflow for setting up direnv in a new project (e.g., create .envrc → add to .gitignore → direnv allow → test). The setup commands are at the end rather than integrated into a clear getting-started sequence. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear section headers, but it's a long monolithic file (~250 lines). Advanced patterns like monorepo setups, Nix integration, and export functions could be split into separate reference files with links from a shorter overview. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
0ebe7ae
Table of Contents
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.