Skip to content
Skills Library
Security · Building & coding

securekit

/securekit

Add application-level encryption to a Python or Node.js project with the securekit library in this repository. Use it to encrypt database fields (including SQLAlchemy models), search encrypted columns, make rows tamper-evident, verify signed webhooks, hash passwords with Argon2id, keep application secrets in an encrypted versioned vault, give each user a server-blind vault, and scan a codebase for unprotected secrets and data. Trigger on tasks about storing PII, passwords, API keys, tokens or secrets, "encrypt this", "make this app secure", key rotation, or removing secrets from a repo.

Repository
securekit ↗
Licence
MIT
Last repository change
03.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Add application-level encryption to a Python or Node.js project with the securekit library in this repository. Use it to encrypt database fields (including SQLAlchemy models), search encrypted columns, make rows tamper-evident, verify signed webhooks, hash passwords with Argon2id, keep application secrets in an encrypted versioned vault, give each user a server-blind vault, and scan a codebase for unprotected secrets and data. Trigger on tasks about storing PII, passwords, API keys, tokens or secrets, "encrypt this", "make this app secure", key rotation, or removing secrets from a repo.

Triggers from the description

encrypt thismake this app secure
Original author description

Add application-level encryption to a Python or Node.js project with the securekit library in this repository. Use it to encrypt database fields (including SQLAlchemy models), search encrypted columns, make rows tamper-evident, verify signed webhooks, hash passwords with Argon2id, keep application secrets in an encrypted versioned vault, give each user a server-blind vault, and scan a codebase for unprotected secrets and data. Trigger on tasks about storing PII, passwords, API keys, tokens or secrets, "encrypt this", "make this app secure", key rotation, or removing secrets from a repo.

How it works

  1. 1. Pick the right tool
  2. 2. Fast path (about an hour for one service)
  3. 3. Recipes
Original SKILL.md headings · 138 lines, 1,455 words
SKILL.md preview
---
name: securekit
description: Add application-level encryption to a Python or Node.js project with the securekit library in this repository. Use it to encrypt database fields (including SQLAlchemy models), search encrypted columns, make rows tamper-evident, verify signed webhooks, hash passwords with Argon2id, keep application secrets in an encrypted versioned vault, give each user a server-blind vault, and scan a codebase for unprotected secrets and data. Trigger on tasks about storing PII, passwords, API keys, tokens or secrets, "encrypt this", "make this app secure", key rotation, or removing secrets from a repo.
---

# securekit: integration skill for AI agents and production teams

You are adding encryption to someone's application. securekit is a **thin layer over vetted primitives** (AES-256-GCM, HMAC-SHA256,
HKDF, Argon2id from `cryptography` / `argon2-cffi` / `node:crypto`). It contains no cryptography of its own. Python and Node.js
produce and read identical tokens, seals, vault files and password hashes (`SPEC.md`).

**Building or reviewing a whole application?** This skill is only the *data-protection* part. Start with `../secure-app/SKILL.md`, which covers the threat model, authentication,
authorization, injection and web attacks, operations and delivery, and calls back here for encryption, secrets and password hashing.

**Say plainly to the user:** securekit is not independently audited and is not a compliance certification. It protects data
*inside the application*. TLS, disk encryption, KMS/HSM custody and backups are still needed: `docs/ENCRYPTION-MAP.md` lists every place and
who covers it.

Paths in this note (`python/`, `node/`, `docs/`, `SPEC.md`) are relative to the `securekit/` folder of this repository. Recipes use names from the
user's own app (`user`, `request`, `db`, `session`) as placeholders; everything from `securekit` is real API and was run as written.

## 1. Pick the right tool

| The task says... | Use | Python | Node.js |
|---|---|---|---|
| store a sensitive value in a database column | field encryption | `FieldCipher(ring).encrypt(v, context("users","ssn",row_id))` | `new FieldCipher(ring).encrypt(v, context('users','ssn',rowId))` |
| the same, with SQLAlchemy | model integration | `securekit.orm.SecureModels` + `EncryptedText` | n/a (use `FieldCipher`) |
| look rows up by an encrypted value (email) | blind index | `BlindIndexer(ring).index(v, context("users","email"))`, `.candidates(...)` for queries | same names, camelCase |
| detect edits to important rows | record seal | `RecordSealer(ring).seal(record, ctx)` / `.verify(...)` | same |
| verify or sign webhooks | request signing | `Signer(ring).verify(body, header)` | same |
| store user passwords | Argon2id | `hash_password`, `verify_password`, `needs_rehash` | `hashPassword`, `verifyPassword`, `needsRehash` |
| remove API keys / DB passwords from code and `.env` | **app secrets vault** | `securekit.vault.Vault` or `python -m securekit vault ...` | `Vault` or `node bin/securekit.js vault ...` |
| data the server must not be able to read | **per-user vault** | `securekit.uservault.UserVault` | `UserVault` |
| session ids, reset tokens | random tokens | `random_token()` | `randomToken()` |
| find what is unprotected in a codebase | scanner | `python -m securekit scan PATH` | (same tool, language independent) |
| a network secrets service with logins and policies | **not securekit** | use OpenBao / HashiCorp Vault / cloud secret manager; feed their data keys to `Keyring` | same |

## 2. Fast path (about an hour for one service)

1. **Install** (this repo is the source): `pip install -e securekit/python` (add `sqlalchemy` for the ORM layer, 2.0.x),
   `npm install ./securekit/node` (Node 24.7+ for Argon2id). Or copy the folder into the project so it is versioned with it.
2. **Make the keyring** once per environment: `python -m securekit genkeyring k1` prints JSON. Put it in the platform secret store
   and expose it to the app as `SECUREKIT_KEYRING`. Never commit it, never put it in an image or the database it protects.
3. **Scan first** to see the starting point: `python -m securekit scan . --fail-on never`. Fix `critical` and `high` items.
4. **Move secrets into the vault**: create it with `securekit vault init`, `printf %s "$VALUE" | securekit vault put NAME`
   for each, then read them at startup (recipe 3.3). Delete the old copies and **rotate anything that was ever in git**.
5. **Encrypt the sensitive columns** (recipes 3.1, 3.2). Decide the `context` for each column before writing data (it cannot change later).
6. **Replace password hashing** with Argon2id (recipe 3.5) and re-hash on login using `needs_rehash`.
7. **Add the checks to CI**: the test suites you wrote plus `python -m securekit scan . --fail-on high`.
8. **Write down** who owns the keyring, the rotation schedule and the restore procedure (`docs/RUNBOOK.md`).

## 3. Recipes

### 3.1 Encrypt a field (Python)

```python
from securekit import Keyring, FieldCipher, context, InvalidToken
ring = Keyring.from_env()                      # SECUREKIT_KEYRING
cipher = FieldCipher(ring)

token = cipher.encrypt("123-45-6789", context("users", "ssn", user.id))   # store this string
ssn = cipher.decrypt_str(token, context("users", "ssn", user.id))          # raises InvalidToken if moved to another row/column
```

```js
const { Keyring, FieldCipher, context } = require('securekit');
const cipher = new FieldCipher(Keyring.fromEnv());
const token = cipher.encrypt('123-45-6789', context('users', 'ssn', user.id));
const ssn = cipher.decryptString(token, context('users', 'ssn', user.id));
```

Use client-generated ids (UUIDs) so the id exists before you encrypt. Add a column for the token (TEXT) and another for a blind index if you search it.

### 3.2 SQLAlchemy 2.0 (Python), automatic

```python
class User(Base):
    __tablename__ = "users"
    id: Mapped[str] = mapped_column(String(36), primary_key=True)
    email: Mapped[str] = mapped_column(EncryptedText)
    email_idx: Mapped[Optional[str]] = mapped_column(String(100), index=True)   # blind index, maintained for you
    role: Mapped[str] = mapped_column(String(20))
    row_seal: Mapped[Optional[str]] = mapped_column(String(200))

secure = SecureModels(Keyring.from_env())
secure.register(User, encrypted=["email"], blind={"email_idx": "email"},
                seal=SealSpec("row_seal", ["id", "role"]), assign_id=lambda: str(uuid.uuid4()))

user = session.scalars(select(User).where(secure.blind_filter(User, "email", "a@x.com�JJK�ۙJ
B����[\�H^Y\�[��ܘ�\ΈY�^\��Y�ܙHH�\�
]]�[�ܙ[Y[�[���Z\�JK�X[Y��[[��\�H�]^X�]H
����[[��Y�][�KZ[�^�[����XX�[�[�ܞ\Y��[[���Y��ܙH܈�[��\�][ۜ�[��[X�
\�\��[XZ[
X
H��[[���[��[�]JH�]\����\\�^��Y[��H������H�\\�^�\�[ݙY�Z\�\�[��[Y��[��H�[��Y�X[Y��[[��Z\�\�[\\�Y���\��ܘ������ˌ�\X�][ۈ�Xܙ]��][���\��^ܝ�P�T�R�U��VT�S��H�
�]�^\�[�˚��ۊH�����HH]�ܛH�Xܙ]�ܙH[���X�[ۂ�^ܝ�P�T�R�UՐUSKݘ\��X��\��Xܙ]˝�][���ۂ�]ۈ[H�X�\�Z�]�][[�]��[��	\����TW��VH�]ۈ[H�X�\�Z�]�][]^[Y[�����\W��^H��[YHۈ�[��]�\�[�\��[Y[��]ۈ[H�X�\�Z�]�][\����]ۂ����H�X�\�Z�][\ܝ�^\�[�™���H�X�\�Z�]��][[\ܝ�][��][H�][��[��˙[��\�ۖȔ�P�T�R�UՐUS�K�^\�[�˙���W�[��
KX�܏H�^[Y[��X\H�B���\W��^HH�][����Y
�^[Y[��ȊK��]����^[Y[�����\W��^H�H�H��\ۙ[��Y\�ۛH]��ۈ�Y�^����˜�ۜ���^\�[���][HH�\]Z\�J	��X�\�Z�]	�N˜�ۜ��][H�][��[����\�˙[����P�T�R�UՐUS�^\�[�˙���Q[��
K�X�܎�	�^[Y[��X\I�JN˜�ۜ���\R�^HH�][����Y
	�^[Y[����K��]��[��	�^[Y[�����\W��^I�N˜���\��[ۜ�\�H�\
�]�\�L�HY�][
K\���X�[[ݙ\�H�\��[ۈ�܈���]Y]������Y�]�\�Y�HKYY\�ݙ\H�[H[�]�\�H�Xܙ]\�H[�X����]H�^\��]�X�\�Z�]�][��]KZ�^\�Y�\�Y[��H�]��[X\�H�^H�H�^\�[�˂�����ˍ�X����‚�]ۂ����H�X�\�Z�][\ܝ�^\�[���Yۙ\���Yۙ\�H�Yۙ\��^\�[�˙���W�[��
JB�Y����Yۙ\���\�Y�J�\]Y\����K�\]Y\��XY\��ȖT�Yۘ]\�H�JN���\^H�[������HY�][�X�ܝ

JB����Yۈ[��]��[���\]Y\��XY\�H�Yۙ\���Yۊ��JH[��[�]\�T�Yۘ]\�B������ˍH\���ܙ‚�]ۂ��ܙYH\��\���ܙ
\���ܙ
H�\��ی�Y�ܙHH��[�šY��\�Y�W�\���ܙ
\���ܙ�ܙY
N��Y��YY�ܙZ\�
�ܙY
N��ܙYH\��\���ܙ
\���ܙ
H�\ܘYH�[[�Hۈ��[����ۈ��K����\�[����\�H���H�X\�\��܈[��XYو�Z[[��]ZY]K��]�\���܈�]\��H\���Y[�˂�����ˍ�\�]\�\��][
�\��\��[����XY
B��]ۂ��][�X�ݙ\�W��^HH\�\��][�ܙX]J\�\��Y\���\�K�]ܙX�ݙ\�OU�YJH�����X�ݙ\�W��^Hۘ�B����]�J\�\��Y�][��]JH���ӈ�]ܘ\Y�^\�ۛB���[�H�][�[�ܞ\�][J���KLH��^�H��ܙHH��[���]\�ۈH�Y[��]H\���\�N���][H\�\��][�[����\�\��Y���Y
\�\��Y
K\���\�JB���H\���\�H]\��]�\��H�[��H�\��\��H�ܙ��[�\���\�H�]�]H�X�ݙ\�H�^HYX[��H]H\��ۙK�]\�H\�Yۋ������ˍ��^H��][ۂ��YH�]��^HY�H�^\�[��[�XZ�H]�[X\�X�Y\H�ۙK�[��܈�Y[��[�\\����]J��[��
X
܂��X�\�K�X\��ٛܗܛ�][ۊؚ�X�܈�S[�[^H����Y�Y�YH�PQQJK[��][��]KZ�^\��܈H�][��[[ݙHH��^B�ۛH�[��YY�ܛ�][ۘ\��[�H]�\�]�\�H[��]Y][��Y\�\�H\��]�Y
H�]\�Y�^H�[���ۙ�\��\�Y�H[JK�����
��[\��܈HY�[���K�
���]�\�ܚ]H[�\��ۈܞ\�ܘ\J��[��]�\��[\�ݙH�H�X�\�Z�]�ۜ��X�[ۋ�\�HHTN�Y�]�[������Y][���^H�˂���
���]�\��[�����[Z]܈\��H�Xܙ]ʊ��^\��][�[Y\�܈\���ܙ�[��Y[��[�[�\��ۈ�[[X\�Y\�܈\��]]��\���Xܙ]�[Y\�ۈ�[�܈��Y�[��\�ۛY[��\�XX�\��]�\�\���[X[�[[�H\��[Y[�˂�ˈ
���]�\���[��[��[Y��[�[\\�Y���\��ܘ܈[\\�Y�][\��ܘ
��[��\��Hۈ�]HY�][�^HYX[�H]H�\�[ݙYY]Y܂�[�ܞ\Y[�\�[��\��^K��\��X�H[K��HY[�Y�Y\�
��H�[YJK[���H�\]Y\����
���]�\���\�H�Y�]H�][���XZ�HH\�\�ʊ�
�\�Y�Hٙ�]Y]�\�Y�X�][ۈٙ�H�ܝ\��^KH�XZ�\�\�
K��K�
�����[��[��^\ˊ��\�H�[�\�]W��^J
X��[��^\�[���H\���\�H\��Z�X�Y\�H����^Hۈ\���K����
���]H�۝^[X�\�][J��
X�K��[[����Y
H[��]�\��[��H]�܈^\�[��]H�]�]�KY[�ܞ\[�˂�ˈ
�����[�^��Y[���H��[[�ʊ��]H�[�[�^
���X[���]\���\�N�\]X[]HXZ�˂��
���^H�]�[XZ[�ˊ��Y�\�[�H�[�\�\��]\��[[���X�Y
�\���X��\��T��\�[��XY�\�H\�[������S�ԖTSӋSPT�Y��K�
������Z[H��\X[��K����^H�\��\ܝ�[�\��K�TPK����ܚȈ][���]�\��\�XZ�\�[�H��\X[����L�Y�H\�\��[��H�][
��\��\���]��[��[��X�Y\��X��[Y[�[�\�X�\�Y��X�[��\�H�X�\�Z�]�]�����Z[ۙK�����
K��\�Y�H�Y�ܙH[�H�^H�ۙH����\����X�\�Z�]�]ۈ	��]ۈ[H[�]\�\��ݙ\�\�\��]���YY��[[�[^H�܈HԓH\��
^H��\�]�]]
B���X�\�Z�]ۛ�H	����HK]\����H���œ]ۈ[H�X�\�Z�]��[��ڙX��KY�Z[[ۈY��H�ڙX�[�H�[��Y�]ۈ[H�X�\�Z�]�][�\�Y�HKYY\�Y�[�H\�YH�][���[��ܚ]H]X\�ۙH\�[�H\�\����ڙX�]�ݙ\�H
���Y�]]�J���H�\\�^[ݙY�[��\����\��Z�X�YZ[�^\›��[�H]X�\�KH[\\�Y�X[Y��[[�\��Y�\�Y�����
���]\��ܜ�YX[���\��܈YX[�[����KK_KK_KK_�[��[Y��[�ܛۙ��^Kܛۙ��۝^Y]Y܈�[��]Y�\\�^�X��H�۝^[��^\�[����]�\�YۛܙH�[�ۛ�ے�^Q\��ܘ��[�ܚ][�[�\�H�^HY]\���[�H�^\�[���\�ܙHH�]\�Y�^H܈�[�\�H��][ۈ�[\\�Y���\��ܘH�X[Y��[[��\��[��Y�]�YHH\�X]\�[�[��Y[����\\�H�]�X��\�[\\�Y�][\��ܘ�][Y]Y�[��]YZ^Y\܈Hܛۙ��^\�[������\�ܙH���H�X��\��X����Yܚ]HX��\����][���Y\��ܘ[��\����\����H����]�N�H����\�[��Z[�]\�\��X]Y\�X�[�ۙY�ܛۙ�\���\�Q\��ܘܛۙ�\���\�H��X�ݙ\�H�^H�[��\�\�\����]H\��Y�Z[��\�H\����\�]��Xܙ]����[�\��ܘ���X�X�]�H�Xܙ]܈�\��[ۈ�X��H�[YH[��\��[ۈ���[�^]��HH�[�[���]܈X�ݙHKY�Z[[ۘ�^܈X\���]�Y]�Y[�\��X�\�Z�]ZYۛܙN��[KZY����
ˈ�[\‚�H�PQQK�Yݙ\��Y]�[�TH�\�0���P˛Y�\�H�ܛX]�
�ܛX]]�JH0������S�ԖTSӋSPT�Y�]�\�HX�H�[�ܞ\0�ˆ���ԕS����˛Y�\�][��]0���X�ܜ�ݙX�ܜ˚��ۘܛ���[[��XY�H\��X�ܜ�0��]ۋ�^[\\��ܛW�]ZX���\��X�[��X�H[[˂

Versions

The database has no other skills named securekit.

Database snapshot: 13.11.2026 · package version 80ab9e869713 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100op-secrets-reader
    Reads secrets from 1Password using the op CLI. Use when the user needs to retrieve passwords, API keys, credentials, documents, or one-time passwords stored in 1Password. Supports reading items by name or ID, extracting specific fields, listing vault contents, and reading secret references.
  • 100envsave
    Use EnvSave to securely retrieve secrets via opaque keys instead of hardcoding them. Trigger whenever code needs API keys, tokens, passwords, database URLs, connection strings, webhook secrets, credentials, environment variables, or any sensitive value. Also trigger when you see…
  • 100secrets-credentials-management
    Use when handling passwords, API keys, tokens, or third-party credentials in a WordPress plugin or theme. Hashes passwords with wp_hash_password / wp_check_password, generates tokens with wp_generate_password, keeps secrets out of code and the database in plaintext, and uses…
  • 90manage-secrets
    Manage encrypted secrets with Ansible Vault and OpenSSL. View, encrypt, decrypt files; encrypt strings; generate RSA keys; file digests. Use when managing vault files or rotating secrets.
  • 100open-vault-passwords
    Use whenever a password, API key, token, private key, database URL with a password, or any other secret is asked for, needs saving, is about to be used, or shows up in the chat context (the user pasted one, a .env file was read). Stores and reads secrets only through Open Vault…
  • 100op-secrets-updater
    Updates existing secrets in 1Password using the op CLI. Use when the user needs to modify passwords, edit field values, add or remove fields, rename items, move items between vaults, or manage tags on existing 1Password items. Supports all item types including Login, Password,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.