talon

Write, deploy, and test Talon voice command files and Python modules.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/wolfmanstout/agent-skills --skill talon-wolfmanstout
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: talon
Source: https://github.com/wolfmanstout/agent-skills/tree/main/src/talon
Command: npx skills add https://github.com/wolfmanstout/agent-skills --skill talon-wolfmanstout

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developing Talon voice command scripts requires knowing .talon file syntax, context matching rules, and the Talon Python API, plus a safe way to deploy and test changes without breaking a live voice setup. This Skill provides the syntax references, deployment workflows, and sandboxed testing procedures needed to work on Talon projects reliably. ## Core Features & Use Cases - Syntax References: Bundled documentation for .talon files, .talon-list files, context headers, captures, actions, and the Talon Python API (ui, clip, cron, canvas, and more). - Deployment Workflows: Deploy changes with talon-install on macOS (live symlinks or worktree snapshots) or sync-talon-repo on WSL, with auto-reload and log inspection guidance. - Sandboxed Testing: Use talonbox to clone disposable macOS VMs, rsync scripts, run mimic() commands, capture screenshots, and verify behavior without touching the host Talon installation. - Use Case: You are adding a new voice command to a Talon package. Write the .talon file using the syntax reference, deploy it with talon-install --snapshot, then clone a talonbox VM and run talonbox mimic to confirm the command triggers correctly before committing. ## Quick Start Ask the agent to write a new .talon voice command file for your project and test it in a talonbox sandbox VM.

Frequently Asked Questions about talon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a Talon voice command file?

Create a .talon file with a context header followed by voice command rules that map spoken phrases to actions. The bundled references cover command syntax, captures, lists, settings, and tags in detail.

How do I test Talon voice commands without affecting my setup?

Use talonbox to clone a disposable macOS VM from the golden image, rsync your scripts into it, and run talonbox mimic to trigger voice commands. Stop the VM when finished and delete it only after the work is approved and committed.

How do I deploy Talon script changes on macOS?

Run talon-install from within the git repo to update the symlink in ~/.talon/user/. Use --live from the main worktree or --snapshot from an alternate worktree, and Talon auto-reloads changed files within seconds.

Can I use the Talon REPL to test behavioral changes?

No, the host REPL should only be used for read-only queries like introspecting registries or testing parsing with sim(). Behavioral tests that depend on application context should run in a talonbox sandbox VM instead.

Why does my Talon package report missing actions or captures?

Some Talon packages depend on the wolfmanstout_talon fork of talonhub/community but have no standard dependency declaration. Sync that fork into the environment alongside the package and rerun the test.