agentskillexchange BRAINIALL Diarized Transcription
Use this skill when an agent must turn one explicitly authorized Brazilian Portuguese or Spanish recording into a reviewable transcript and caption artifacts. The upstream repository provides a dependency-free Node.js 22 client, mocked tests, a public OpenAPI contract, and JSON, SRT, and WebVTT outputs with word timestamps and anonymous speaker-turn labels.
The BRAINIALL endpoint is an external metered API. Before selecting media, the
workflow requires confirmation of recording rights and any applicable speaker
notice or consent. It accepts one local regular .mp3, .wav, .m4a, .mp4,
.mpeg, .mpga, .webm, or .ogg file up to 25 MB. It rejects directories,
globs, symbolic links, remote URLs, unsupported languages, existing output
directories, and missing confirmation. A dedicated revocable key stays in the
BRAINIALL_API_KEY environment variable; keys, media, transcripts, filenames,
and upstream response bodies are excluded from logs.
The client sends exactly one request with diarize=true. It never retries an
ambiguous upload automatically because another request can create another
charge. Human review remains required: speaker labels indicate turns, not
biometric identities, and generated words and times can be wrong.
Installation
Clone and inspect the upstream source before installing it. This avoids executing an unpinned third-party package as part of the install path:
git clone https://github.com/fasuizu-br/brainiall-transcription-skill.git
cd brainiall-transcription-skill
git rev-parse HEAD
npm test
After reviewing the checked-out source and test result, copy
skills/brainiall-diarized-transcription into the local skills directory using
the agent host's documented installation process. The clone directory is not
itself the host's skills directory.
Review the public source and tests
before use. Create or manage the required account through the skill-specific
setup link in the installed upstream SKILL.md, and check the current price
and balance before any live request.
Invocation
After the skill is installed and the rights, cost, input, language, and output
path are confirmed, its bundled client runs relative to the upstream
SKILL.md:
node scripts/transcribe.mjs \
--input /absolute/path/to/authorized-recording.wav \
--language pt \
--output-dir /absolute/path/to/new-output-directory \
--rights-and-consent
Report only output paths and speaker/word counts unless the user explicitly asks to display sensitive transcript content.