CLI de Gestión de Secretos para Sesiones con IA

Qué hace

Evita pegar API keys directamente en una sesión de chat con IA. Guarda los secretos una sola vez en un gestor de secretos (Doppler u otro) y comparte con el asistente solo el nombre de la variable. Incluye validaciones que rechazan un portapapeles vacío, un nombre de variable pegado como si fuera el valor, o contenido que cambió a mitad del flujo, además de un escáner de transcripciones y un importador de archivos .env.

Cuándo usarla

• Al configurar credenciales para un proyecto que usa un asistente de IA en el entorno de desarrollo
• Al migrar un archivo .env existente hacia un gestor de secretos centralizado
• Al auditar transcripciones de sesiones pasadas para detectar secretos expuestos accidentalmente

Pasos

1. Registrar cada secreto una sola vez en el gestor de secretos elegido
2. Configurar el comando que inyecta el secreto al entorno sin mostrarlo en pantalla
3. Validar que el portapapeles no esté vacío ni contenga el nombre de la variable como valor
4. Confirmar que el valor no cambió entre la copia y el uso dentro del flujo
5. Ejecutar el escáner de transcripciones para detectar secretos pegados por error en el historial
6. Importar y migrar cualquier archivo .env suelto hacia el gestor central

La skill

---
name: secrets-manager-cli
description: Store API keys in a secrets manager once, then hand the AI assistant the variable name, never the value, with anti-mistake validations.
---

# CLI de Gestión de Secretos

## Cuándo usarlo
Cuando trabajas con un asistente de IA en el terminal y necesitas usar API keys sin pegarlas nunca directamente en el chat.

## Principio central
El secreto vive una sola vez en el gestor (Doppler o equivalente). El asistente solo conoce el nombre de la variable; el valor real nunca aparece en la conversación.

## Validaciones del comando set
Rechaza portapapeles vacío, rechaza un nombre de variable pegado como si fuera el valor, y detecta si el contenido cambió entre la copia y el uso.

## Escáner de transcripciones
Revisa historiales de sesiones anteriores en busca de secretos que se hayan pegado por error, para poder rotarlos de inmediato.

## Importador de .env
Migra archivos .env sueltos del proyecto hacia el gestor central, dejando el entorno local libre de texto plano sensible.

## Reglas de seguridad
Nunca se muestra el valor real de un secreto en el chat ni en logs compartidos. Cualquier rotación o eliminación de secretos requiere confirmación explícita del usuario. No se asumen valores de secretos no verificados.

Para Claude Code, guárdala en ~/.claude/skills/secrets-manager-cli/SKILL.md. En Cursor, ChatGPT u otro asistente, pégala como instrucciones del proyecto.