CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

env-secrets-manager

Manage environment-variable hygiene and secrets safety across local development and production. Practical auditing, drift awareness, rotation readiness. Use when auditing .env files for committed secrets, planning a credential rotation, debugging missing-env-var production incidents, or hardening a new project against secrets leakage.

61

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./engineering/skills/env-secrets-manager/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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.

The skill body has a solid executable core (auditor script quick start, tool configs, rotation workflows with verification gates), but it is bloated: long sections of cloud-provider and CI/CD general knowledge duplicate what Claude already knows and what the reference files already cover. The strongest fix is moving the Cloud/CI/CD/Audit sections into references/ and keeping SKILL.md as a lean overview.

Suggestions

Move the Cloud Secret Store Integration, CI/CD Secret Injection, and Audit Logging sections into a new reference file (e.g., references/cloud-and-cicd-secrets.md) and replace them with one-line pointers, cutting SKILL.md to a lean overview.

De-duplicate the Secret Rotation Workflow against references/validation-detection-rotation.md (which already contains a six-step rotation workflow) — keep one canonical version and cross-link it.

Add an explicit validation step to the Recommended Workflow (e.g., 'Re-run scripts/env_auditor.py to confirm no findings remain') and fix the .pre-commit-config.yaml block so it is fenced as yaml, not bash.

DimensionReasoningScore

Conciseness

Roughly 150 lines re-explain general knowledge Claude already has: cloud secret store provider comparison tables, GitHub Actions/GitLab secret injection conventions, audit-log alerting strategies, and generic advice like 'Never echo or print secret values'. The Secret Rotation section also duplicates the rotation workflow already detailed in references/validation-detection-rotation.md. Several padded sections of known material — anchor 2, not 3, because the padding is section-level rather than isolated sentences.

2 / 5

Actionability

The Quick Start gives executable commands against a real script ('python3 scripts/env_auditor.py /path/to/repo --json'), the gitleaks TOML config is copy-paste ready, and detect-secrets baseline commands are concrete. Minor gaps: the .pre-commit-config.yaml content is fenced as bash rather than yaml, and the rotation/alerting sections give direction without commands — anchor 4 rather than 5.

4 / 5

Workflow Clarity

The Recommended Workflow is a clear 5-step sequence, and the rotation workflow embeds verification checkpoints ('Verify each consumer can authenticate', 'Revoke the old credential only after all consumers are confirmed healthy') plus an emergency checklist with a defined order. Anchor 4 rather than 5 because the primary Recommended Workflow lacks an explicit validation step (e.g., re-run the auditor to confirm no secrets remain) after the rotate-and-cleanup steps.

4 / 5

Progressive Disclosure

References are clearly signaled in a dedicated 'Reference Docs' section and both referenced files exist, and the Quick Start is appropriately lean. However, the Cloud Secret Store Integration, CI/CD Secret Injection, Pre-Commit Secret Detection, and Audit Logging sections (~150 lines) are inline general-reference material that belongs in the references/ files — anchor 3 (content that should be separate is inline), not 4 (only minor organization gaps).

3 / 5

Total

13

/

20

Passed

Description

87%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.

A strong description: it explicitly states what the skill does and provides an explicit, multi-scenario 'Use when' clause with natural trigger phrases. The only weakness is mild abstraction in the capability framing ('hygiene', 'drift awareness', 'rotation readiness') and a few missing common synonyms.

Suggestions

Replace abstract nouns in the what-statement ('Practical auditing, drift awareness, rotation readiness') with concrete verbs, e.g., 'Audit .env files for committed secrets, detect config drift between environments, and plan credential rotation.'

Add a few high-frequency synonyms to the when-clause, such as 'leaked API keys', '.env.example', or 'environment variables', to widen trigger coverage.

DimensionReasoningScore

Specificity

The when-clause names concrete actions ("auditing .env files for committed secrets", "planning a credential rotation", "debugging missing-env-var production incidents"), but the what-statement leans on semi-abstract terms like "environment-variable hygiene" and "rotation readiness". This lists several specific actions with minor abstraction gaps — anchor 4, not 5, which demands comprehensively concrete phrasing throughout.

4 / 5

Completeness

Both questions are explicitly answered: what ("Manage environment-variable hygiene and secrets safety… Practical auditing, drift awareness, rotation readiness") and an explicit "Use when…" clause with four concrete trigger scenarios. This mirrors anchor 5's pattern of a clear what paired with explicit, concrete when-triggers; anchor 4 would require the when to be less specific than it is.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: ".env files", "committed secrets", "credential rotation", "missing-env-var production incidents", "hardening", "secrets leakage". A few common variations are missing (e.g., "leaked credentials", "API keys", ".env.example"), matching anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (env-file hygiene, secret leak auditing, rotation planning) with distinct triggers unlikely to fire for unrelated skills. Overlap with a vault-infrastructure skill is possible but the described scope (local dev .env auditing, incident debugging) is distinguishable — anchor 5.

5 / 5

Total

18

/

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

alirezarezvani/claude-skills

Path

engineering/skills/env-secrets-manager/SKILL.md

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.