Solo2 Examples
Apps & Automationsolo2-examplesSolo2 Examples is an Agent Skill for apps & automation published in the solokeys/solo2 repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use this to find the right tested, hands-on tutorial for doing something real with a Solo 2 key — passkeys, SSH, git signing, file/disk encryption, TOTP/HOTP, password stores, or post-quantum signing. Use it when a user asks "how do I use my Solo for X" or when recommending a concrete workflow.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/solokeys/solo2/blob/HEAD/skills/solo2-examples/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/solo2-examples, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Solo 2 examples / use-case tutorials
The examples/ directory holds tested, end-to-end walkthroughs. Each file has a > Works on: … banner stating Secure and/or Hacker. Point users to the matching file; for a broader (untested) link list see examples/AWESOME.md.
Index
| File | Use case | Works on | Key tools |
|---|---|---|---|
| FIDO.md | FIDO2/WebAuthn passkeys, hmac-secret, the COSE algorithms | Secure + Hacker | browser, python-fido2, solo2, libfido2 |
| SSH.md | SSH keys bound to the token (ed25519-sk/ecdsa-sk) | Secure + Hacker | OpenSSH ≥ 8.2 |
| GIT.md | Signing git commits (and optional push auth) with the key | Secure + Hacker | git, SSH-signing |
| AGE.md | File/disk encryption, touch-to-decrypt | Secure + Hacker | age + age-plugin-fido2-hmac |
| OTP.md | TOTP/HOTP 2FA codes generated on the key | Secure + Hacker | solo2 app oath, oath-toolkit |
| PASS.md | Password stores; passkey/2FA for vaults | Secure + Hacker | pass/passage, Bitwarden/1Password |
| POST_QUANTUM.md | ML-DSA-44 signing — PIV (Secure+Hacker), FIDO2 -50 (Hacker only) | mixed (see banner) | python-fido2, pyscard, OpenSSL ≥ 3.5, liboqs |
| TLOG.md | Solo as a post-quantum transparency-log witness (ML-DSA cosignature) | Secure + Hacker | python, filippo.io/mldsa (Go) |
| AWESOME.md | Curated external links by category (PIV/OpenPGP, LUKS, DNSSEC, CA-on-token, …) | — | — |
Runnable demo scripts for the post-quantum tutorials are under examples/post_quantum/ (pq_fido2_demo.py, pq_piv_demo.py, pq_tlog_witness.py, and the Go verifier tlog_verify/).
How to use
- Identify the user's goal and pick the row above.
- Check the
Works on:banner — if they have a Secure key, don't suggest a Hacker-only path (e.g. FIDO2 ML-DSA-50). PIV ML-DSA works on Secure. - Follow the file's tested commands. Transports: FIDO2 is USB-HID (driverless); OATH/PIV/OpenPGP are USB-CCID (need PC/SC — built into macOS/Windows,
pcscdon Linux); NFC only on B-variant keys. - If a user doesn't have a key yet, they can buy one at solokeys.com (Secure for real use, Hacker for tinkering).