Skip to main content
skill CX Codex

secrets-management · sickn33 — Claude Code skill: what it does, how to install

secrets-management — a skill that walks an agent through secret handling in CI/CD: picking a backend, scoping access, rotating credentials and proving values never reach logs or artifacts.

MIT ★ 50,109 updated 2026-10-29

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sickn33/agentic-awesome-skills --skill secrets-management -a claude-code
Open on GitHub

What secrets-management does

The skill turns a vague request to keep secrets safe into a sequence. It starts by asking which secrets exist, who owns them and which processes read them, then picks a backend already in the stack: Vault, a cloud secret manager or the protected store on the host. Environment boundaries and least privilege get written down rather than assumed. Vault and GitHub Actions each have a companion file inside the skill, references/vault-setup.md and references/github-secrets.md, and dev mode with root tokens is treated as unfit for production.

Where the backend allows it, retrieval moves to short-lived workload identity. Before switching that on, the agent checks issuer, audience and workload restrictions, and confirms a denied request actually fails. Rotation runs in four stages: prepare, switch the consumer, verify, revoke the old credential. Retries are the trap — they must not leave the database and the secret store holding different passwords.

Masking does not make logging secrets safe. A value that reached output gets revoked or rotated; deleting the log line is not enough. Secrets also linger in infrastructure state, subprocess environments and backups, so those boundaries need a look. The skill expects an authorized system: it will not touch live credentials or deploy secret infrastructure on its own. Verification runs on synthetic markers through logs, error paths, artifacts and crash reports.

What it helps with

  • pick a secret backend that matches the existing stack
  • split access between environments and individual jobs
  • move credential issuing to short-lived workload identity
  • run a rotation that leaves no split credentials behind
  • prove logs and artifacts contain no secret values

Example prompts for the agent

  • Trace how the deploy job gets its database password and give that retrieval to the trusted job only.
  • Check the pipeline for secrets leaking into logs or build artifacts, then propose a rotation plan.
  • Set up Vault retrieval for CI without a root token or dev mode.

How to install secrets-management

1Skills CLI (Vercel)

npx skills add sickn33/agentic-awesome-skills --skill secrets-management -a claude-code

2Manually: put the files in place

~/.claude/skills/secrets-management/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/secrets-management/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about secrets-management

How do I install secrets-management in Claude Code?

Run npx skills add sickn33/agentic-awesome-skills --skill secrets-management -a claude-code. The skill file lands at ~/.claude/skills/secrets-management/SKILL.md.

What does secrets-management do?

It works through how a pipeline obtains secrets: backend choice, access policy, short-lived identity and rotation. It also checks that values stay out of logs, artifacts and error reports.

Is masking enough to keep secrets out of logs?

No. Once a value has reached output, revoke or rotate it. Removing the log entry alone leaves the credential live.

Source text

SKILL.md · MIT
---
name: secrets-management
description: "Secure secrets management practices for CI/CD pipelines using Vault, AWS Secrets Manager, and other tools."
risk: critical
source: community
date_added: "2026-02-27"
---

# Secrets Management

## When to Use

Design or repair secret retrieval, CI credentials, workload identity, access policies and rotation for an authorized system.

## Inputs

Identify secret names and owners, consumers, environments, authentication mechanism and the rotation/recovery policy. Inspect configuration without displaying values.

## Procedure

1. Choose the existing supported backend: Vault, a cloud secret manager or the host's protected secret store. Keep environment boundaries and minimum privileges explicit.
2. For Vault, read `references/vault-setup.md`. Development mode and root tokens are not production configuration.
3. For GitHub Actions, read `references/github-secrets.md`. Keep pull-request validation separate from privileged jobs. Supply values to the consuming process, never interpolate them into generated shell source or print them for debugging.
4. Prefer short-lived workload identity when the backend supports it. Check issuer, audience, workload/environment restrictions and denied access before enabling retrieval.
5. Rotate through prepare, consumer switch, verification and old-credential revocation. Use the backend's supported rotation protocol; retries must not leave the database and secret store on different credentials.
6. Inspect logs, error paths, artifacts and crash reports with synthetic secret markers. Record metadata such as operation, principal and outcome rather than values.

## Example

A deployment needs a database credential. The trusted job retrieves it through the configured identity and passes it only to the migration process. Test missing access and an expired identity in staging. Verify no credential appears in output, and that a failed rotation leaves a recoverable working state.

## Verification

- Authorized retrieval succeeds; a different workload or environment is denied.
- Missing credentials fail closed without exposing values.
- Rotation and rollback are exercised with synthetic data.
- Logs and artifacts contain no secret markers, including on failure.
- Exposed credentials are revoked or rotated; merely deleting their log entry is insufficient.

## Limitations

Masking cannot make logging secrets safe. Secret data can persist in infrastructure state, subprocess environments or backups; review those boundaries explicitly. Do not alter real credentials or deploy secret infrastructure without authorization.

## Sources

- [GitHub secure workflow guidance](https://docs.github.com/en/actions/reference/security/secure-use)
- [Vault production hardening](https://developer.hashicorp.com/vault/docs/concepts/production-hardening)

© sickn33 · MIT · sickn33/agentic-awesome-skills

Similar skills

All skills for Security →

secrets-management by other authors comes first.

secrets-management Seth Hobson The secrets-management skill sets up secrets handling for CI/CD with Vault, AWS Secrets Manager, and platform stores. Use it for credentials, rotation, and protected deployments. CX Codex +1 13,122installs Secrets Management taste f Secrets Management taste — a prompt for ChatGPT that defines security standards and best practices for secrets management. GP ChatGPT ★ 178,201repo stars secrets-env-manager patricio0312rev secrets-env-manager validates environment variables in CI workflows, enforces secret masking, and catches leaked keys early. CX Codex +1 276installs secrets-in-git-history UseOSINT secrets-in-git-history — a skill that teaches the agent to hunt API keys, tokens and identities in git history and on GitHub, not just in the checked-out tree. CX Codex +1 1,900installs secrets-scanner patricio0312rev secrets-scanner catches leaked keys, tokens and passwords in a repo, with checks before commit and in CI. Handy when a .env file or a live key already slipped into history. CX Codex +1 287installs hunt-cicd Sachin Sharma hunt-cicd — a skill for Claude that walks through build-system attack surface: Jenkins consoles, GitHub Actions injection, OIDC role trust, leaked Terraform state. Fits targets with a reachable pipeline. CX Codex +1 ★ 16,193repo stars secrets-vault-manager Alireza Rezvani The secrets-vault-manager skill helps manage infrastructure-level secrets across Vault and cloud stores, with access policies, rotation, and auditing for services and operators. CX Codex +1 697installs

From the same set187

The whole set →
seo-content-auditor seo-content-auditor reads the draft you hand it, scores depth, E-E-A-T, readability and keyword use, then lists fixes. Useful before a post goes live. CX Codex +1 ★ 50,109repo stars pci-compliance pci-compliance traces payment data through your project and gathers control evidence for a scoped PCI assessment. It does not certify compliance. CX Codex +1 ★ 50,109repo stars security-compliance-compliance-check security-compliance-compliance-check guides regulatory compliance checks for GDPR, HIPAA, SOC2, and PCI-DSS, generating gap analyses, checklists, and technical control code. CX Codex +1 ★ 50,109repo stars varlock-claude-skill The varlock-claude-skill skill adds explicit checks for environment variables and secret exposure across Claude sessions, terminals, logs, and Git commits. CX Codex +1 ★ 50,109repo stars security-scanning-security-sast security-scanning-security-sast — a skill for static code analysis (SAST) that detects vulnerabilities, hardcoded secrets, and security policy violations across multiple languages and frameworks. CX Codex +1 ★ 50,109repo stars distributed-debugging-debug-trace distributed-debugging-debug-trace sets up debugging and distributed tracing: trace boundaries, key spans, correlation IDs, and a check that traces actually cover the request path. CX Codex +1 ★ 50,109repo stars distributed-tracing Guides distributed tracing setup with OpenTelemetry, Jaeger, and Tempo across microservices. Prevents leaking secrets into spans and verifies collector error handling. CX Codex +1 ★ 50,109repo stars observability-monitoring-slo-implement observability-monitoring-slo-implement is a Claude Code skill for defining SLI and SLO targets, setting error budgets, and planning reliability monitoring tied to product priorities. CX Codex +1 ★ 50,109repo stars

Project sponsors

Companies that keep this analytics open