Install with an AI Agent
OSTT ships an official agent skill: a single instruction file that teaches AI coding agents how to install, configure, and troubleshoot OSTT. Your agent can then run the setup steps from these docs for you.
What is an agent skill?
A skill is a portable instruction file (SKILL.md) in the open skills ecosystem. When you add it to a skill-aware agent (such as Claude Code), the agent gains OSTT-specific knowledge: installation steps, provider and model setup, hotkey configuration, processing actions, local models, and troubleshooting. The agent can then give you accurate commands and run them for you.
You don't need to know the skills system; the command below is enough.
Add the skill
The skill is distributed with the skills CLI from Vercel Labs. npx (from Node.js) downloads and runs the CLI on demand.
npx skills add https://github.com/kristoferlund/ostt-skillThis installs the OSTT skill into the skills directory of every skill-aware agent npx skills detects on your machine. The first time you run it, npx asks to download the skills package.
Use it
Once the skill is added, talk to your agent in plain language. For example:
- "Install OSTT and set up Deepgram as the provider."
- "Bind OSTT to
Alt+Spaceon Hyprland with paste output." - "Upgrade my Omarchy 3.x OSTT hotkey and popup rules to the Omarchy 4.x Lua config."
- "OSTT says
command not foundafter install: fix my PATH." - "Download a local Whisper model and run it with GPU acceleration."
- "Add a processing action that cleans up filler words."
The agent uses the skill to respond with correct OSTT commands and configuration, and can apply them for you.
Keeping it up to date
Re-run the same command to pull the latest version of the skill:
npx skills add https://github.com/kristoferlund/ostt-skillSource
The skill is open source. Browse or contribute at github.com/kristoferlund/ostt-skill. For the skills CLI itself (supported agents, options, and how the ecosystem works), see skills.sh.