For AI agents#

arioso ships artifacts for coding agents alongside its code. This page lists them, says where each lives in the repository, and points at the machine-readable copies of this documentation.

Skills#

Skills are folders holding a SKILL.md (the Agent Skills format): a description that tells an agent when to use it and a body with the procedure. Install one into your agent with gh skill (any host: --agent claude-code, copilot, cursor, codex, gemini), or use the copy bundled in the wheel.

arioso#

Generate music with AI using the arioso package — one Python interface over 16 music-generation backends (Suno, ElevenLabs Music, Udio, YuE, ACE-Step, MusicGen, Stable Audio, Stable Audio 2.5, Riffusion, Harmonai, Lyria, Mubert, Beatoven, Loudly, Jen). Use when the user wants to “make a song”, “generate music”, “write a song about X”, “turn this poem/text/script into a song”, “set these lyrics to music”, “text to music”, “make a theme tune”, “I need background music”, or “a royalty-free instrumental track” — or when they name a platform (Suno, ElevenLabs Music, Udio, MusicGen, Stable Audio, Riffusion, Lyria). Covers the one-line call, which five backends can actually SING lyrics you wrote (the other eleven drop them silently), the Suno customMode title/genre requirement, which backends are free versus paid, polling an async job, and writing the audio to disk.

gh skill install thorwhalen/arioso arioso --agent claude-code

Source: arioso/data/skills/arioso (bundled with the pip package).

The bundled skills are also on disk after pip install arioso, under the package’s data/skills/ directory; link them into an agent without network access with skill link-skills <that directory>.

Instruction files#

Files agents read before working in this repository.

Machine-readable documentation#

This site publishes the same documentation in forms that fit an agent’s context window:

  • llms.txt: an index of every page with a one-line description (llms.txt format)

  • arioso.md: the whole documentation as one Markdown file

  • <page>.html.md: a rendered Markdown twin of every page, advertised from each page’s <head> with <link rel="alternate" type="text/markdown">

  • objects.inv: the Sphinx inventory: a symbol-to-URL index (sphobjinv convert plain objects.inv -)