A robust auditing tool to detect environment variable alias conflicts and missing required configurations before deployment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install env-alias-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install env-alias-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Env Alias Audit?
Env Alias Audit is a specialized utility designed to prevent runtime failures caused by inconsistent environment variables. As part of the Openclaw Skills ecosystem, it allows developers to define canonical keys and their associated aliases, ensuring that different naming conventions for the same configuration—such as DATABASE_URL versus DB_URL—do not lead to conflicting values or missing required setup.
This skill is essential for maintaining configuration integrity across complex staging and production environments. By integrating this tool into your development lifecycle, you ensure that your Openclaw Skills scripts and agents always have access to synchronized and valid configuration data.
Env Alias Audit Use Cases
- Pre-deployment validation of .env files to ensure all required configuration groups are present and correctly mapped.
- Identifying conflicting values where multiple aliases for the same secret or setting have been defined with different data.
- Auditing legacy codebases to ensure canonical keys have been correctly implemented alongside older environment aliases.
- Enforcing strict environment variable compliance within CI/CD pipelines as a standardized step for Openclaw Skills users.
How Env Alias Audit Works
- The skill parses a specified environment file, typically a .env file, to extract all defined keys and values.
- It evaluates these variables against a built-in or custom alias specification file that maps canonical keys to their known aliases.
- It checks for the presence of required groups as defined by the user in the input parameters.
- It detects conflicts where different aliases within the same logical group contain differing values, which could cause unpredictable application behavior.
- It generates a detailed report marking each group as OK, WARN, or FAIL and exits with a status code 1 if strict requirements are not met, allowing for automated failure in build pipelines.
Env Alias Audit Setup
To use this tool within your Openclaw Skills collection, ensure you have bash and python3 available in your environment. You can trigger an audit with the following commands:
# Run a basic audit for required keys
ENV_FILE=.env REQUIRED_GROUPS=DATABASE_URL,STRIPE_API_KEY bash skills/env-alias-audit/scripts/audit-env-aliases.sh
# Run an audit with a custom alias specification and report mode
ENV_FILE=.env.production ALIAS_SPEC_FILE=path/to/alias-spec.txt AUDIT_MODE=report bash skills/env-alias-audit/scripts/audit-env-aliases.sh
Env Alias Audit Data Schema & Taxonomy
The skill utilizes a straightforward text-based schema for alias mapping and generates a structured status report.
| Component | Format | Description |
|---|---|---|
| Alias Spec | CANONICAL=ALIAS1,ALIAS2 |
Defines the canonical key and its related aliases per line. |
| Input Env | .env standard |
Standard key-value pair file format used for environment configuration. |
| Output Report | CLI Stdout | Provides a per-group status (OK/WARN/FAIL) and a final execution summary. |
Env Alias Audit Advanced Features
- Custom Alias Specifications: Define your own mapping files to handle unique naming conventions across different cloud providers or frameworks.
- Strict Audit Mode: Automatically fail CI/CD builds or deployment scripts if required environment groups are missing or if value drift is detected.
- Conflict Detection: Performs deep analysis of values to ensure that different aliases pointing to the same configuration source are perfectly synchronized.
- Flexible Input Support: Compatible with various .env file variations, making it a versatile choice for Openclaw Skills users managing complex infrastructures.
SKILL.md
Loading
Related Openclaw Skills
Dockerfile Hardening Audit
Statically audit Dockerfiles to identify and mitigate security risks before container deployment.
CI Flake Triage
A powerful utility for identifying and prioritizing flaky tests by analyzing JUnit retry artifacts within your CI pipeline.
McDonald's China MCP Order Lite
A streamlined MCP-based skill for automating McDonald's China delivery orders, menu lookups, and coupon management via official API protocols.
Perpetua
A hosted OAuth proxy that enables seamless data retrieval from Oura Ring and Google Calendar using a single master API key.
GitHub Actions Actor Reliability Audit
An automated auditing tool that ranks GitHub Actions reliability by identifying high-risk contributors and flaky automation owners through run history analysis.
GitHub Actions Artifact Budget Audit
Audit GitHub Actions artifact storage from JSON exports to identify and flag oversized artifacts before they inflate CI costs.
Featured*
