CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

secrets-management

Implement secure secrets management for CI/CD pipelines using Vault, AWS Secrets Manager, or native platform solutions. Use when handling sensitive credentials, rotating secrets, or securing CI/CD environments.

Quality

78%

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 ./plugins/cicd-automation/skills/secrets-management/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 body is rich with copy-paste-ready examples across Vault, AWS, GitHub, GitLab, and Kubernetes, making it genuinely actionable. Its weaknesses are structural: no organizing workflow or platform-selection guidance, no validation checkpoints in the rotation flows, padded tool-overview sections, and a monolithic single-file layout where per-platform reference files would serve better.

Suggestions

Add an explicit decision workflow at the top (choose platform -> store -> retrieve -> rotate -> scan) with validation checkpoints in each rotation flow, e.g. verify the new secret works before revoking the old one.

Split the per-platform guides (Vault integration, AWS Secrets Manager, Kubernetes External Secrets Operator, rotation recipes) into reference files linked from a lean SKILL.md overview, instead of inlining all ~345 lines.

Cut content Claude already knows: the four tool-feature bullet lists, the Purpose section duplicating the description, and the generic best-practices list; replace with platform-specific pitfalls that are not common knowledge.

DimensionReasoningScore

Conciseness

The bulk of the body is appropriate, executable code, but several sections explain things Claude already knows: four tool-feature bullet lists ("Centralized secrets management", "Dynamic secrets generation", "HSM-backed keys"), a "Purpose" section that restates the frontmatter description, and a generic 10-item best-practices list. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 2 because the code examples dominate and earn their tokens.

3 / 5

Actionability

Most guidance is concrete and executable: complete vault CLI commands, GitHub Actions and GitLab YAML, AWS CLI calls, Terraform HCL, Kubernetes ExternalSecret manifests, and a pre-commit scanning hook. It falls short of 5 because the rotation Lambda example invokes undefined helpers ("generate_strong_password()", "update_database_password()"), making that snippet non-executable as written.

4 / 5

Workflow Clarity

The body is a per-platform recipe catalog with no overall decision sequence (no 'choose your platform, then store, retrieve, and rotate' flow), and the manual rotation list buries its only checkpoint as step 4 of 5. Per the rubric guideline, rotation is a risky/destructive operation and the automated Lambda rotation flow has no validation or verification steps, capping this dimension at 3.

3 / 5

Progressive Disclosure

Section headers are clear and well-ordered, but all ~345 lines live in a single SKILL.md with zero bundle files or references. Content that clearly belongs in separate files (the Vault integration guide, AWS Secrets Manager guide, Kubernetes External Secrets Operator, rotation recipes) is fully inlined. This matches anchor 3; it is not 4 because no references exist at all, and the under-50-lines exception for a 5 does not apply.

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 that explicitly states both what it does and when to use it, with named tools and natural trigger phrases. It could reach the top of the specificity and trigger-term scales by enumerating more granular capabilities (store, retrieve, mask, scan) and adding common synonyms like API keys, passwords, and tokens.

DimensionReasoningScore

Specificity

The description names concrete tools ("using Vault, AWS Secrets Manager, or native platform solutions") and several operations ("Implement secure secrets management", "rotating secrets", "handling sensitive credentials"), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because the actions are less granular than a fully enumerated capability list (e.g., no storing/retrieving/masking verbs).

4 / 5

Completeness

Both questions are explicitly answered: the 'what' is "Implement secure secrets management for CI/CD pipelines using Vault, AWS Secrets Manager, or native platform solutions" and the 'when' is "Use when handling sensitive credentials, rotating secrets, or securing CI/CD environments" with three concrete trigger phrases. This matches the anchor-5 example structure; a 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural trigger terms users would actually say are present: "secrets management", "Vault", "AWS Secrets Manager", "sensitive credentials", "rotating secrets", "CI/CD". A few common synonyms are missing (e.g., "API keys", "passwords", "tokens", "environment variables"), which fits anchor 4 rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (secrets management for CI/CD pipelines) with distinct triggers naming specific tools (Vault, AWS Secrets Manager). It is unlikely to fire for unrelated skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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

wshobson/agents

Path

plugins/cicd-automation/skills/secrets-management/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.