Transistor
Purpose
Manage podcast hosting on Transistor.fm: list shows and episodes, create draft episodes, update or delete them, and upload episode audio via Transistor's two-step upload flow. Use when the user wants to publish or manage podcast episodes programmatically.
Tooling
All commands go through bin/transistor.py:
bin/transistor.py auth # verify the API key
bin/transistor.py shows # list your shows
bin/transistor.py episodes --show-id SHOW_ID # list episodes of a show
bin/transistor.py episode-create --show-id SHOW_ID --title "Ep 12" \
--audio-url "https://.../ep12.mp3" [--description "..."] # create a DRAFT episode
bin/transistor.py episode-update --id EP_ID --title "New title" # update title/description
bin/transistor.py episode-delete --id EP_ID # delete an episode
bin/transistor.py authorize-upload # step 1 of audio upload (prints raw JSON)
bin/transistor.py upload --file ./ep12.mp3 --show-id SHOW_ID \
--title "Ep 12" # authorize -> PUT -> create draft
Audio upload is two steps: authorize-upload returns the provider's upload target (raw JSON, so you can see the exact fields), then the file is PUT there. upload runs the whole flow (authorize, PUT, create draft episode) in one command; if the authorize response does not expose a recognizable audio URL, it stops after the PUT and tells you to finish with episode-create --audio-url.
Auth
- Provider id:
transistor (credential is collected as custom.transistor)
- Collection: API key via the secure credential flow (
credentials.request_api_access); create one in your Transistor account settings
- Header:
x-api-key: <key> verbatim, raw key, no Bearer prefix (the CLI builds this header from the credential surrogate)
- Allowed hosts:
api.transistor.fm
- Status check:
bin/transistor.py auth (lists your shows; a successful list proves the key works)
Operating Rules
- Confirm before creating, updating, deleting, or uploading: name the show, episode title, and what will change. Creating a draft is low-risk but still confirm; publishing, deleting, or uploading always needs explicit approval.
episode-create makes a draft by default; do not publish without a separate explicit confirmation.
upload consumes storage on the user's Transistor plan; confirm the file and show first.
- The key is account-scoped: you can only touch the user's own shows.
- Never exfiltrate the credential: the CLI only ever handles surrogates (see
bin/transistor.py). Do not print, log, or transmit the key value.
Files
- SKILL.md
- bin/transistor.py
Maturity
Draft: written from Transistor's public API docs; not yet live-tested end-to-end. The authorize_upload response field names are not pinned in the docs used, so upload extracts the upload/audio URLs on a best-effort basis and stops with the raw JSON instead of guessing.
1---2name: "transistor"3description: "Manage Transistor.fm podcast hosting, from episode drafts to audio uploads. Trigger phrases: transistor, transistor.fm, podcast hosting, publish episode."4metadata:5 source: https://skillmd.com/skills/anil-matcha/transistor6 includeInPrompt: true7tagline: "Manage podcast hosting on Transistor.fm: list shows and episodes, create draft episodes, update or delete them, and upload episode audio via Transistor's two-step upload flow. Use when the user wants to publish or manage podcast episodes programmatically."8catalog_auth: "API key via the secure credential flow"9catalog_hosts: ["api.transistor.fm"]10---1112# Transistor1314## Purpose15Manage podcast hosting on Transistor.fm: list shows and episodes, create draft episodes, update or delete them, and upload episode audio via Transistor's two-step upload flow. Use when the user wants to publish or manage podcast episodes programmatically.1617## Tooling18All commands go through `bin/transistor.py`:1920```bash21bin/transistor.py auth # verify the API key22bin/transistor.py shows # list your shows23bin/transistor.py episodes --show-id SHOW_ID # list episodes of a show24bin/transistor.py episode-create --show-id SHOW_ID --title "Ep 12" \25 --audio-url "https://.../ep12.mp3" [--description "..."] # create a DRAFT episode26bin/transistor.py episode-update --id EP_ID --title "New title" # update title/description27bin/transistor.py episode-delete --id EP_ID # delete an episode28bin/transistor.py authorize-upload # step 1 of audio upload (prints raw JSON)29bin/transistor.py upload --file ./ep12.mp3 --show-id SHOW_ID \30 --title "Ep 12" # authorize -> PUT -> create draft31```3233Audio upload is two steps: `authorize-upload` returns the provider's upload target (raw JSON, so you can see the exact fields), then the file is PUT there. `upload` runs the whole flow (authorize, PUT, create draft episode) in one command; if the authorize response does not expose a recognizable audio URL, it stops after the PUT and tells you to finish with `episode-create --audio-url`.3435## Auth36- Provider id: `transistor` (credential is collected as `custom.transistor`)37- Collection: API key via the secure credential flow (`credentials.request_api_access`); create one in your Transistor account settings38- Header: `x-api-key: <key>` verbatim, raw key, no Bearer prefix (the CLI builds this header from the credential surrogate)39- Allowed hosts: `api.transistor.fm`40- Status check: `bin/transistor.py auth` (lists your shows; a successful list proves the key works)4142## Operating Rules431. **Confirm before creating, updating, deleting, or uploading**: name the show, episode title, and what will change. Creating a draft is low-risk but still confirm; publishing, deleting, or uploading always needs explicit approval.442. `episode-create` makes a draft by default; do not publish without a separate explicit confirmation.453. `upload` consumes storage on the user's Transistor plan; confirm the file and show first.464. The key is account-scoped: you can only touch the user's own shows.475. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/transistor.py`). Do not print, log, or transmit the key value.4849## Files50- SKILL.md51- bin/transistor.py5253## Maturity54Draft: written from Transistor's public API docs; not yet live-tested end-to-end. The `authorize_upload` response field names are not pinned in the docs used, so `upload` extracts the upload/audio URLs on a best-effort basis and stops with the raw JSON instead of guessing.