← Explore all skills

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.

Upstream setup instructions ↗

DOCUMENTED COMMAND

/plugin install azure-sdk-python@skills

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. The plugin README shows `/plugin install azure-sdk-python@skills`. That installs the azure-sdk-python plugin, not this one file.
  2. The same README also shows `npx skills add microsoft/skills --skill azure-sdk-python`.
  3. 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.
  4. 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.

  1. 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

  2. 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

  3. 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

  4. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: MIT License

  5. https://raw.githubusercontent.com/microsoft/skills/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-python/skills/azure-ai-transcription-py/SKILL.md

    Supports: upstreamDescription, bestFor, review

Evidence & Ask