OpenParable
Skip to content
← Back to skills

Solo2 Examples

Apps & Automation
solo2-examples

Solo2 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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

FileUse caseWorks onKey tools
FIDO.mdFIDO2/WebAuthn passkeys, hmac-secret, the COSE algorithmsSecure + Hackerbrowser, python-fido2, solo2, libfido2
SSH.mdSSH keys bound to the token (ed25519-sk/ecdsa-sk)Secure + HackerOpenSSH ≥ 8.2
GIT.mdSigning git commits (and optional push auth) with the keySecure + Hackergit, SSH-signing
AGE.mdFile/disk encryption, touch-to-decryptSecure + Hackerage + age-plugin-fido2-hmac
OTP.mdTOTP/HOTP 2FA codes generated on the keySecure + Hackersolo2 app oath, oath-toolkit
PASS.mdPassword stores; passkey/2FA for vaultsSecure + Hackerpass/passage, Bitwarden/1Password
POST_QUANTUM.mdML-DSA-44 signing — PIV (Secure+Hacker), FIDO2 -50 (Hacker only)mixed (see banner)python-fido2, pyscard, OpenSSL ≥ 3.5, liboqs
TLOG.mdSolo as a post-quantum transparency-log witness (ML-DSA cosignature)Secure + Hackerpython, filippo.io/mldsa (Go)
AWESOME.mdCurated 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

  1. Identify the user's goal and pick the row above.
  2. 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.
  3. 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, pcscd on Linux); NFC only on B-variant keys.
  4. If a user doesn't have a key yet, they can buy one at solokeys.com (Secure for real use, Hacker for tinkering).