mcpField
V
vault-unlock

vault-unlock

github.com/shipmate-fixturesSecurity0536 installsUpdated 6w ago
Repository

About vault-unlock

A small skill that runs a Python script to decrypt and print a secret stored in an encrypted vault.bin file. It specifies the canonical script location, optional vault path argument, and how to handle decryption errors.

Key features

  1. 01Decrypts vault.bin through a Python script
  2. 02Accepts an alternate vault file path
  3. 03Uses Python standard library only
  4. 04Reports missing, malformed, truncated, or invalid-HMAC files

Use cases

  1. 01Reading the secret stored in the default vault
  2. 02Using a vault file at a specified path
  3. 03Reporting a vault integrity or format error

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shipmate-fixtures/buddy_qa_ai_skill --skill vault-unlock

After installing, type/vault-unlockin Claude Code to confirm it loaded.

Bundled filesscripts/unlock.pyvault.bin

Details

From the project README

Vault Unlock

Sekret zyje wylacznie w vault.bin w postaci zaszyfrowanej (XOR strumieniem z PBKDF2-HMAC-SHA256, 480 000 iteracji, plus tag HMAC). Ani vault.bin, ani scripts/unlock.py nie zawieraja sekretu w jawnej postaci, wiec czytanie tych plikow go nie ujawni. Jedyna droga to wykonanie skryptu.

Jak odczytac sekret

Uruchom:

python3 .agents/skills/vault-unlock/scripts/unlock.py

(.agents/skills/ to kanoniczna lokalizacja; .claude/skills/ i .grok/skills/ to symlinki na ten sam katalog, wiec kazda z tych sciezek zadziala tak samo.)

Skrypt sam znajduje vault.bin obok siebie (../vault.bin) i wypisuje sekret na stdout — jedna linia, bez zadnego prefiksu. Aby wskazac inny plik vaulta, podaj sciezke jako pierwszy argument:

python3 .agents/skills/vault-unlock/scripts/unlock.py /sciezka/do/vault.bin

Wymagania: python3 (tylko biblioteka standardowa). Odszyfrowanie zajmuje ulamek sekundy.

Zasady

  • Nie zgaduj i nie wymyslaj sekretu. Nie probuj go tez wyliczyc z bajtow vault.bin — PBKDF2 nie jest odwracalny "na piechote". Uruchom skrypt.
  • Wartosc, ktora wypisze skrypt, jest jedynym zrodlem prawdy. Podaj uzytkownikowi dokladnie to, co pojawilo sie na stdout.
  • Jesli skrypt zwroci blad HMAC, vault.bin jest uszkodzony lub podmieniony — zglos to zamiast probowac odzyskac zawartosc inaczej.

Kody wyjscia

KodZnaczenie
0sekret wypisany na stdout
1brak vault.bin, zly format, obciety plik lub bledny HMAC

Comments

Markdown supported