SPEECH TRANSCRIPTION / Microsoft
Azure AI Transcription for Python
Pins Microsoft's Python transcription skill, which prefers DefaultAzureCredential in production and says never to hardcode credentials.
“Azure AI Transcription SDK for Python. Use for real-time and batch speech-to-text transcription with timestamps and diarization. Triggers: "transcription", "speech to text", "Azure AI Transcription", "TranscriptionClient". ”
01 / THE REASONING
Why this made the selection.
- The file says two auth modes are supported, and that production code should prefer DefaultAzureCredential and never hardcode credentials.
- It says the subscription key is not needed when DefaultAzureCredential or a TokenCredential is used, and that every client should be closed with a context manager.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- .github/plugins/azure-sdk-python/skills/azure-ai-transcription-py/SKILL.md
- README.md
- .github/plugins/azure-sdk-python/README.md
- LICENSE
Our findings
- The file says key auth and DefaultAzureCredential or any TokenCredential are both supported.
- It says to prefer DefaultAzureCredential in production and never to hardcode credentials in code.
- It says TRANSCRIPTION_KEY is for key auth and is not needed when a token credential is used.
- It says to pick sync or async and not to mix them, and to wrap every client in a context manager.
Not established by this review
- The resource was not executed and its tools were not called.
- No Azure client was constructed and no credential was used.
- The linked reference files were not opened.
- The azure-sdk-python plugin was not installed.
- No audio file was sent and no transcription job was started.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
/plugin install azure-sdk-python@skills Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The plugin README shows `/plugin install azure-sdk-python@skills`. That installs the azure-sdk-python plugin, not this one file.
- The same README also shows `npx skills add microsoft/skills --skill azure-sdk-python`.
- The repository README shows `npx skills add microsoft/skills`, which starts a wizard for the repository, and `/plugin install azure@skills` for a different plugin.
- The skill shows `pip install azure-ai-transcription` for the SDK package. That line was not run.
Before you start
- Python if the skill's pip line is run; this review did not run it
- A transcription endpoint in TRANSCRIPTION_ENDPOINT
- Either TRANSCRIPTION_KEY or a DefaultAzureCredential, as the skill's two auth modes describe
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-transcription-py/SKILL.md
Supports: production token preference, no hardcoded credentials, and optional key auth
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/README.md
Supports: /plugin install azure-sdk-python@skills installs the plugin, not one file
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: MIT statement, Copilot CLI plugin install, and a different azure plugin command
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: MIT License
https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-transcription-py/SKILL.md
Supports: upstreamDescription, bestFor, review