Secrets Vault Manager
Category: Engineering
Domain: Secrets Management & Security
Overview
The Secrets Vault Manager skill provides tools for generating HashiCorp Vault configurations, planning and scheduling secret rotation cycles, and analyzing vault audit logs for suspicious access patterns. Essential for teams managing secrets at scale.
Clarify First
Before generating configs or plans, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
# Generate Vault configuration
python scripts/vault_config_generator.py --env production --secrets-engines kv,database,transit
# Plan secret rotation schedule
python scripts/rotation_planner.py --inventory secrets_inventory.json
# Analyze vault audit logs
python scripts/audit_log_analyzer.py --log-file vault_audit.log --format json
Tools Overview
| Tool |
Purpose |
Key Flags |
vault_config_generator.py |
Generate HashiCorp Vault configurations |
--env, --secrets-engines, --auth-methods |
rotation_planner.py |
Plan and schedule secret rotation cycles |
--inventory, --policy, --format |
audit_log_analyzer.py |
Analyze vault audit logs for anomalies |
--log-file, --time-range, --format |
Workflows
Initial Vault Setup
- Define environment and required secrets engines
- Run
vault_config_generator.py to generate HCL configs
- Review and customize generated configurations
- Apply via Terraform or Vault CLI
Secret Rotation Planning
- Create secrets inventory (JSON)
- Run
rotation_planner.py to generate schedule
- Review rotation plan and adjust frequencies
- Implement automated rotation where possible
Audit Log Investigation
- Export vault audit logs
- Run
audit_log_analyzer.py for anomaly detection
- Review flagged events
- Investigate suspicious access patterns
Reference Documentation
- Secrets Management Guide - Best practices, rotation policies, and compliance requirements
Common Patterns
Secret Classification
- Critical: Database credentials, API master keys, encryption keys
- High: Service account tokens, OAuth secrets, TLS certificates
- Medium: Third-party API keys, webhook secrets
- Low: Public API keys, non-sensitive configuration
1---
2name: secrets-vault-manager
3description: >
4 This skill should be used when the user asks to "generate Vault configurations",
5 "plan secret rotation", "analyze vault audit logs", "manage secrets lifecycle",
6 or "set up HashiCorp Vault".
7license: MIT + Commons Clause
8metadata:
9 version: 1.0.0
10 author: borghei
11 category: engineering
12 domain: secrets-management
13 updated: 2026-04-02
14 tags: [secrets, vault, hashicorp, rotation, audit, security]
15---
16
17# Secrets Vault Manager
18
19> **Category:** Engineering
20> **Domain:** Secrets Management & Security
21
22## Overview
23
24The **Secrets Vault Manager** skill provides tools for generating HashiCorp Vault configurations, planning and scheduling secret rotation cycles, and analyzing vault audit logs for suspicious access patterns. Essential for teams managing secrets at scale.
25
26## Clarify First
27
28Before generating configs or plans, confirm these inputs. If any is unknown or vague, ASK — do not assume:
29
30- [ ] **Task** — config generation / rotation planning / audit-log analysis (selects the script and the entire workflow)
31- [ ] **Environment & secrets engines** — e.g. production + kv/database/transit (`--env`, `--secrets-engines`; shapes the generated HCL)
32- [ ] **Secrets inventory & classification** — Critical/High/Medium/Low per secret (drives rotation frequencies and the schedule)
33
34Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
35
36## Quick Start
37
38```bash
39# Generate Vault configuration
40python scripts/vault_config_generator.py --env production --secrets-engines kv,database,transit
41
42# Plan secret rotation schedule
43python scripts/rotation_planner.py --inventory secrets_inventory.json
44
45# Analyze vault audit logs
46python scripts/audit_log_analyzer.py --log-file vault_audit.log --format json
47```
48
49## Tools Overview
50
51| Tool | Purpose | Key Flags |
52|------|---------|-----------|
53| `vault_config_generator.py` | Generate HashiCorp Vault configurations | `--env`, `--secrets-engines`, `--auth-methods` |
54| `rotation_planner.py` | Plan and schedule secret rotation cycles | `--inventory`, `--policy`, `--format` |
55| `audit_log_analyzer.py` | Analyze vault audit logs for anomalies | `--log-file`, `--time-range`, `--format` |
56
57## Workflows
58
59### Initial Vault Setup
601. Define environment and required secrets engines
612. Run `vault_config_generator.py` to generate HCL configs
623. Review and customize generated configurations
634. Apply via Terraform or Vault CLI
64
65### Secret Rotation Planning
661. Create secrets inventory (JSON)
672. Run `rotation_planner.py` to generate schedule
683. Review rotation plan and adjust frequencies
694. Implement automated rotation where possible
70
71### Audit Log Investigation
721. Export vault audit logs
732. Run `audit_log_analyzer.py` for anomaly detection
743. Review flagged events
754. Investigate suspicious access patterns
76
77## Reference Documentation
78
79- [Secrets Management Guide](references/secrets-management-guide.md) - Best practices, rotation policies, and compliance requirements
80
81## Common Patterns
82
83### Secret Classification
84- **Critical**: Database credentials, API master keys, encryption keys
85- **High**: Service account tokens, OAuth secrets, TLS certificates
86- **Medium**: Third-party API keys, webhook secrets
87- **Low**: Public API keys, non-sensitive configuration