Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

AudioScape agent skills

The public distribution repo for AudioScape's Claude Code, Codex, Cursor, and other agents integration.

This repo is published automatically from AudioScape's private monorepo. Issues and support: developer.audioscape.ai.

Install

/plugin marketplace add AudioScapeInc/agent-skills
/plugin install audioscape@audioscape
/audioscape:login

Requires Claude Code v2.1.195+. Sign-in shows a short code you enter at developer.audioscape.ai/activate — works over SSH. During early access, approving sign-in requires an enrolled account; contact the AudioScape team for an invite.

What's public here, and why

An agent integration has two halves. The server half (catalog search, audio intelligence, the MCP endpoint) runs on our infrastructure and needs an authenticated request. The client half has to live on your device and it's this repo:

Component What it does on your machine
plugins/audioscape/mcp.json Connects Claude Code to mcp.audioscape.ai, attaching your token via a header helper
scripts/login.sh OAuth device-flow sign-in (short code, approved in your browser); writes ~/.audioscape/token.env (0600)
scripts/headers-helper.sh Serves and silently refreshes that token for the MCP connection
scripts/kit-sync.sh Keeps the audio-* skills in ~/.claude/skills current, automatically, before any of them run
scripts/reset.sh Returns the machine to a brand-new-user state
commands/ /audioscape:login, /audioscape:reset

How the pieces fit

flowchart LR
  subgraph you["Your machine"]
    CC["Claude Code<br/>(the agent)"]
    PLUGIN["audioscape plugin<br/>(this repo)"]
    SKILLS["~/.claude/skills/audio-*<br/>(auto-synced skills)"]
    TOKEN["~/.audioscape/token.env"]
  end
  subgraph audioscape["AudioScape (server-side)"]
    PORTAL["developer.audioscape.ai<br/>OAuth + /activate"]
    MCP["mcp.audioscape.ai<br/>MCP server + /kit"]
  end

  PLUGIN -- "login.sh: device code" --> PORTAL
  PORTAL -- "you approve in browser" --> TOKEN
  PLUGIN -- "headers-helper.sh reads/refreshes" --> TOKEN
  CC -- "MCP calls (Bearer token)" --> MCP
  PLUGIN -- "kit-sync.sh checks /kit/version<br/>before any audio-* skill runs" --> MCP
  MCP -- "current skill files" --> SKILLS
  CC -- "invokes" --> SKILLS
Loading

On every session start and every time an audio-* skill is invoked, kit-sync.sh compares your installed kit version against the server. If it's behind, it stages the new kit, swaps it in atomically (previous version kept as *.bak), and the skill runs the current version. touch ~/.audioscape/kit-pin opts out.

Uninstall / revoke

/audioscape:reset (or scripts/reset.sh) revokes the server-side grant and removes all local state; /plugin uninstall audioscape removes the plugin. You can also revoke the MCP - AudioScape Claude Code Plugin key any time at developer.audioscape.ai/keys.

About

Official AudioScape plugins and agent skills for Claude Code

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages