Przejdź do treści
Biblioteka skilli
Bezpieczeństwo · Budowanie i kod

pqblocks

/pqblocks

Wdraża, migruje i audytuje kryptografię odporną na komputery kwantowe: ML-KEM, ML-DSA, SLH-DSA, hybrydy, CBOM i zgodność z CNSA 2.0.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
33
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Wdraża, migruje i audytuje kryptografię odporną na komputery kwantowe: ML-KEM, ML-DSA, SLH-DSA, hybrydy, CBOM i zgodność z CNSA 2.0.

Oryginalny opis (EN)

Post-quantum engineering with the PQBlocks packages. Use when adding, migrating or auditing cryptography for the quantum threat (ML-KEM / FIPS 203, ML-DSA / FIPS 204, SLH-DSA / FIPS 205, Kyber, Dilithium, hybrid X25519 + ML-KEM), signing or encrypting JWTs post-quantum, encrypting files post-quantum, finding RSA / ECC in code, producing a CBOM, CNSA 2.0 compliance, checking TLS for X25519MLKEM768, running NIST ACVP vectors, or solving QUBO / Ising / Max-Cut problems with quantum-inspired solvers.

Jak działa

  1. Rules
  2. Which package for which task
  3. Migration workflow
  4. Reference files
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 1 345 słów
Podgląd SKILL.md
---
name: pqblocks
description: Post-quantum engineering with the PQBlocks packages. Use when adding, migrating or auditing cryptography for the quantum threat (ML-KEM / FIPS 203, ML-DSA / FIPS 204, SLH-DSA / FIPS 205, Kyber, Dilithium, hybrid X25519 + ML-KEM), signing or encrypting JWTs post-quantum, encrypting files post-quantum, finding RSA / ECC in code, producing a CBOM, CNSA 2.0 compliance, checking TLS for X25519MLKEM768, running NIST ACVP vectors, or solving QUBO / Ising / Max-Cut problems with quantum-inspired solvers.
---

<!-- GENERATED by scripts/gen_skills.py from data/catalog.json - do not edit by hand -->

# PQBlocks: post-quantum engineering

PQBlocks is an open-source organisation that builds verified post-quantum (PQ) components: cryptography, migration and readiness tooling, protocol interoperability, conformance testing and quantum-inspired optimisation. 32 packages, Apache-2.0, docs at https://pqblocks.github.io.

## Rules

1. **Use the documented API only.** Before writing code with a PQBlocks package, read its reference file
   below (or call the `get_snippet` tool of the `pqblocks-mcp` server). Every quickstart there was executed
   against the package. Never guess function names.
2. **Never hand-roll post-quantum cryptography.** Use the packages; they wrap maintained implementations
   (liboqs, pyca/cryptography).
3. **Hybrid by default during the transition:** ML-KEM-768 + X25519 for key establishment, ML-DSA-65 +
   Ed25519 for signatures. Downgrade to classical-only must be explicit.
4. **Randomness from the OS only.** Never pass a `seed` argument when generating production keys; seeds
   exist for reproducible tests.
5. **Never log or return secret keys or shared secrets** (logs, exceptions, HTTP responses, `repr`).
6. **Say exactly what is true.** PQBlocks packages implement FIPS 203/204/205 and test against official
   vectors where they exist. They are **not** FIPS 140-3 / CMVP validated, not externally audited, and
   pre-1.0. Never call them certified, validated, audited or quantum-proof.
7. **Quantum-inspired packages are optimisation, not cryptography.** Never place them in a security path.
8. **Install lines:** use the exact install line listed for each package; most install from GitHub
   until their PyPI release is published.

## Which package for which task

| Task | Package | Install | Import |
|---|---|---|---|
| ML-KEM / ML-DSA / SLH-DSA primitives (keygen, encapsulate, sign) | [`pqblocks-primitives`](reference/primitives.md) | `pip install pqblocks-primitives` | `pqblocks_primitives` |
| Hybrid ML-KEM-768 + X25519 key establishment, native speed | [`pqblocks-core`](reference/core.md) | `pip install git+https://github.com/PQBlocks/hybrid-sdk` | `pqblocks_core` |
| Sign or verify JWTs / JWS with ML-DSA; encrypt JWE with ML-KEM | [`pqblocks-jose`](reference/jose.md) | `pip install pqblocks-jose` | `pqblocks_jose` |
| Encrypt files or byte strings to a post-quantum public key | [`pqblocks-files`](reference/files.md) | `pip install pqblocks-files` | `pqblocks_files` |
| Find RSA / ECC / weak hashes in code or a TLS endpoint; CBOM + SARIF | [`pqblocks-scan`](reference/scan.md) | `pip install pqblocks-scan` | `pqblocks_scan` |
| Python crypto data-flow linting; CBOM + SARIF | [`pqblocks-lint`](reference/lint.md) | `pip install pqblocks-lint` | `pqblocks_lint` |
| Enrich a CycloneDX CBOM with quantum-safety and CNSA 2.0 tags | [`pqblocks-cbom`](reference/cbom.md) | `pip install pqblocks-cbom` | `pqblocks_cbom` |
| Crypto-agility readiness score and CI regression gate | [`pqblocks-agility`](reference/agility.md) | `pip install pqblocks-agility` | `pqblocks_agility` |
| Policy-as-code: fail CI on forbidden algorithms | [`pqblocks-policy`](reference/policy.md) | `pip install pqblocks-policy` | `pqblocks_policy` |
| Audit which JWE / JOSE algorithms a gateway accepts | [`pqblocks-jwe-audit`](reference/jwe-audit.md) | `pip install pqblocks-jwe-audit` | `pqblocks_jwe_audit` |
| CNSA 2.0 compliance evidence pack | [`pqblocks-cnsa-evidence`](reference/cnsa-evidence.md) | `pip install pqblocks-cnsa-evidence` | `pqblocks_cnsa_evidence` |
| Probe a TLS 1.3 endpoint for X25519MLKEM768; hybrid key-schedule checks | [`pqblocks-tls-interop`](reference/tls-interop.md) | `pip install pqblocks-tls-interop` | `pqblocks_tls_interop` |
| Binary container for ML-KEM ciphertexts and ML-DSA / SLH-DSA signatures | [`pqblocks-wire`](reference/wire.md) | `pip install pqblocks-wire` | `pqblocks_wire` |
| Five-part hybrid JWE wire layout (serialise / parse only, no encryption) | [`pqblocks-jwe`](reference/jwe.md) | `pip install pqblocks-jwe` | `pqblocks_jwe` |
| ML-KEM certificate signing request with proof of possession | [`pqblocks-csr-pop`](reference/csr-pop.md) | `pip install pqblocks-csr-pop` | `pqblocks_csr_pop` |
| Run NIST ACVP vectors against ML-KEM / ML-DSA implementations | [`pqblocks-acvp`](reference/acvp.md) | `pip install pqblocks-acvp` | `pqblocks_acvp` |
| Reject malformed or wrong-length FIPS 203/204 inputs at a boundary | [`pqblocks-fips-check`](reference/fips-check.md) | `pip install pqblocks-fips-check` | `pqblocks_fips_check` |
| Verify post-quantum X.509 certificate chains in browser or Node.js | [`pqblocks-browser-pqc-verifier`](reference/browser-pqc-verifier.md) | `npm install @pqblocks/browser-pqc-verifier` | `@pqblocks/browser-pqc-verifier` |
| Build or convert QUBO / Ising models | [`pqblocks-qubo`](reference/qubo.md) | `pip install pqblocks-qubo` | `pqblocks_qubo` |
| Solve QUBO / Ising / Max-Cut (Simulated Bifurcation) | [`pqblocks-bifurcation`](reference/bifurcation.md) | `pip install pqblocks-bifurcation` | `pqblocks_bifurcation` |
| Simulated annealing / quantum annealing / population annealing / QIEA solvers | [`pqblocks-anneal-sa`](reference/anneal-sa.md), [`pqblocks-anneal-sqa`](reference/anneal-sqa.md), [`pqblocks-population-anneal`](reference/population-anneal.md), [`pqblocks-qiea`](reference/qiea.md) | `pip install pqblocks-anneal-sa` | `pqblocks_anneal_sa` |
| Benchmark QUBO / Ising solvers (time-to-solution) | [`pqblocks-qubo-bench`](reference/qubo-bench.md) | `pip install pqblocks-qubo-bench` | `pqblocks_qubo_bench` |

## Migration workflow

1. **Discover:** run `pqblocks-scan` on the code base (and `pqblocks-tls-interop` on endpoints).
2. **Assess:** enrich the CBOM with `pqblocks-cbom`; score with `pqblocks-agility`.
3. **Govern:** gate CI with `pqblocks-policy`; build evidence with `pqblocks-cnsa-evidence`.
4. **Migrate:** `pqblocks-primitives` / `pqblocks-core` for primitives, `pqblocks-jose` for tokens, `pqblocks-files` for files.
5. **Verify:** `pqblocks-acvp` against NIST vectors; `pqblocks-fips-check` at input boundaries.

## Reference files

Each file holds the package summary, install line, import, command-line entry points and its executed quickstart. Read the one you need before writing code.

- [`pqblocks-core`](reference/core.md): Post-quantum hybrid cryptography core SDK with C shared libraries and policy enforcement.
- [`pqblocks-files`](reference/files.md): Hybrid post-quantum file encryption: ML-KEM-768 plus X25519 key encapsulation with chunked ChaCha20-Poly1305 in the pfsh v1 format.
- [`pqblocks-fips-dualmode`](reference/fips-dualmode.md): Dual-mode cryptographic abstraction switching between FIPS 140-3 classical crypto (ECDH/AES-GCM) and post-quantum crypto (ML-KEM/ML-DSA).
- [`pqblocks-jose`](reference/jose.md): Post-quantum hybrid JOSE library supporting ML-KEM and ML-DSA JWE and JWS tokens.
- [`pqblocks-primitives`](reference/primitives.md): Production-ready integrated post-quantum cryptographic primitives (ML-KEM, ML-DSA, SLH-DSA, and hybrid schemes).
- [`pqblocks-qse-sdk`](reference/qse-sdk.md): Post-quantum cryptography SDK for ML-KEM, ML-DSA, and SLH-DSA (FIPS 203/204/205)
- [`pqblocks-agility`](reference/agility.md): Cryptographic Agility Readiness Scoring (CARS) and CI/CD regression firewall for CycloneDX 1.6 CBOM inventories.
- [`pqblocks-cbom`](reference/cbom.md): CycloneDX 1.5 CBOM metadata enrichment engine injecting quantum-safe classifications and CNSA 2.0 compliance properties.
- [`pqblocks-cnsa-evidence`](reference/cnsa-evidence.md): CNSA 2.0 evidence pack generator for quantum-safe compliance, CBOM generation, and migration scheduling.
- [`pqblocks-jwe-audit`](reference/jwe-audit.md): High-throughput JSON Web Encryption (JWE) cryptographic policy auditor enforcing CNSA 2.0 and NIST FIPS 203 PQC standards.
- [`pqblocks-lint`](reference/lint.md): Static analysis for Python source that finds classical and post-quantum cryptographic primitives with a source-to-sink taint pass and reports them as a CycloneDX 1.6 CBOM or a SARIF 2.1.0 log.
- [`pqblocks-policy`](reference/policy.md): Policy-as-code engine for post-quantum cryptography compliance and CBOM verification.
- [`pqblocks-pqc-compat-registry`](reference/pqc-compat-registry.md): A machine-readable registry of NIST post-quantum algorithm identifiers (FIPS 203/204/205 OIDs) for compliance tooling.
- [`pqblocks-scan`](reference/scan.md): Cryptography inventory scanner: finds classical and post-quantum algorithms in source code or a TLS endpoint and writes a CycloneDX 1.6 CBOM, a SARIF 2.1.0 report and a readiness grade.
- [`pqblocks-csr-pop`](reference/csr-pop.md): ML-KEM (FIPS 203) PKCS#10 Certificate Signing Request (CSR) generator with RFC 9883 Proof of Possession (PoP).
- [`pqblocks-jwe`](reference/jwe.md): Compact five-part wire format, with a serializer and structural parser, for hybrid ML-KEM-768 + X25519 JWE-style tokens; it performs no encryption itself.
- [`pqblocks-tls-interop`](reference/tls-interop.md): TLS 1.3 hybrid key exchange (X25519MLKEM768 / RFC 10024) endpoint probe, downgrade detector, and key material validator.
- [`pqblocks-wire`](reference/wire.md): Length-prefixed container format (PQCWF1) for ML-KEM ciphertexts and ML-DSA / SLH-DSA signatures, with thin wrappers over liboqs-python and pyca/cryptography; it implements no primitive itself.
- [`pqblocks-acvp`](reference/acvp.md): Cross-implementation NIST ACVP conformance harness for FIPS 203 (ML-KEM) and FIPS 204 (ML-DSA).
- [`pqblocks-browser-pqc-verifier`](reference/browser-pqc-verifier.md): Post-quantum certificate and chain verifier for browsers and Node.js using ML-DSA/SLH-DSA from @noble/post-quantum.
- [`pqblocks-fips-check`](reference/fips-check.md): FIPS 203/204 boundary validator and hybrid key exchange (X25519 + ML-KEM-768) with ML-DSA-65 signatures and CBOM reporting.
- [`pqblocks-pqc-acvp-runner`](reference/pqc-acvp-runner.md): NIST FIPS 203 and 204 ACVP Known Answer Test runner and Wycheproof harness in Node.js.
- [`pqblocks-anneal-sa`](reference/anneal-sa.md): Simulated Annealing heuristic solver for Ising and QUBO optimization problems. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-anneal-schedule`](reference/anneal-schedule.md): Quantum-inspired instance-adaptive simulated annealing with statistics-driven schedule generation for Ising and QUBO optimization problems. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-anneal-sqa`](reference/anneal-sqa.md): Simulated Quantum Annealing (Path-Integral Monte Carlo via Suzuki-Trotter decomposition) heuristic solver for Ising and QUBO optimization. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-bifurcation`](reference/bifurcation.md): Simulated Bifurcation (ballistic and discrete) heuristic solver for Ising and QUBO problems. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-digital-anneal`](reference/digital-anneal.md): Digital Annealer-style parallel-trial heuristic solver for Ising and QUBO optimization problems. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-population-anneal`](reference/population-anneal.md): Population Annealing Monte Carlo heuristic solver for Ising models and QUBO combinatorial optimization. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-qiea`](reference/qiea.md): Quantum-Inspired Evolutionary Algorithm (QIEA) with Q-bit representations and quantum rotation gates for Ising and QUBO optimization problems. Quantum-inspired classical optimization, not cryptography.
- [`pqblocks-qubo`](reference/qubo.md): Unified mathematical representation and converter library for Quadratic Unconstrained Binary Optimization (QUBO) and Ising formulations.
- [`pqblocks-qubo-bench`](reference/qubo-bench.md): Benchmarking harness and standard instance loaders for quantum-inspired optimization algorithms against classical baselines.
- [`pqblocks-sparse-bifurcation`](reference/sparse-bifurcation.md): Sparse Discrete Simulated Bifurcation (dSB) heuristic solver for large-scale Ising and QUBO combinatorial optimization.
Pliki w paczce (33)
  • SKILL.md 12 KB
  • reference/acvp.md 3 KB
  • reference/agility.md 3 KB
  • reference/anneal-sa.md 3 KB
  • reference/anneal-schedule.md 3 KB
  • reference/anneal-sqa.md 3 KB
  • reference/bifurcation.md 3 KB
  • reference/browser-pqc-verifier.md 5 KB
  • reference/cbom.md 2 KB
  • reference/cnsa-evidence.md 4 KB
  • reference/core.md 2 KB
  • reference/csr-pop.md 3 KB
  • reference/digital-anneal.md 3 KB
  • reference/files.md 3 KB
  • reference/fips-check.md 3 KB
  • reference/fips-dualmode.md 2 KB
  • reference/jose.md 4 KB
  • reference/jwe-audit.md 2 KB
  • reference/jwe.md 3 KB
  • reference/lint.md 3 KB
  • reference/policy.md 2 KB
  • reference/population-anneal.md 3 KB
  • reference/pqc-acvp-runner.md 2 KB
  • reference/pqc-compat-registry.md 3 KB
  • reference/primitives.md 2 KB
  • reference/qiea.md 3 KB
  • reference/qse-sdk.md 2 KB
  • reference/qubo-bench.md 2 KB
  • reference/qubo.md 2 KB
  • reference/scan.md 3 KB
  • reference/sparse-bifurcation.md 2 KB
  • reference/tls-interop.md 3 KB
  • reference/wire.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie pqblocks.

Migawka bazy z 13.11.2026 · wersja paczki dc0d79ad4b8e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100applied-cryptography-post-quantum-pqc-kyber-dilithium
    Wyjaśnia standardy postkwantowej kryptografii NIST, w tym ML-KEM (Kyber) i ML-DSA (Dilithium), i ich wpływ na projekt systemu.
  • 100post-quantum-crypto
    Planuje przejście na kryptografię postkwantową: terminy zagrożenia, standardy NIST, wdrożenie hybrydowe, inwentaryzację i zwinność kryptograficzną.
  • 100performing-post-quantum-cryptography-migration
    Ocenia gotowość organizacji do migracji na kryptografię postkwantową wg NIST FIPS 203, 204 i 205, z przeglądem algorytmów podatnych na kwanty.
  • 100migrating-to-post-quantum-cryptography
    Pomaga przejść na kryptografię postkwantową: spis używanej kryptografii, hybrydową wymianę kluczy TLS, VPN i SSH oraz priorytety według ryzyka HNDL.
  • 100post-quantum-crypto-poc
    Buduje dowód koncepcji hybrydowej wymiany kluczy i podpisów postkwantowych w TLS, mierzy rozmiar i opóźnienie uzgadniania.
  • 100crypto-tls-pqc-readiness
    Spisuje, gdzie projekt polega na kryptografii klucza publicznego podatnej na komputery kwantowe i co się zepsuje po włączeniu PQC.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.