{
  "markdown": "# BRAINIALL diarized transcription skill\n\nAn installable Agent Skill for converting one explicitly authorized Brazilian\nPortuguese or Spanish recording into speaker-labelled JSON, SRT, and WebVTT.\nIt uses the external metered BRAINIALL transcription API and includes a tested,\ndependency-free Node.js 22 client.\n\n## Install\n\nInstall from reviewed source instead of executing an unpinned package runner:\n\n```bash\ngit clone https://github.com/fasuizu-br/brainiall-transcription-skill.git\ncd brainiall-transcription-skill\ngit rev-parse HEAD\nnpm test\n```\n\nRecord the commit returned by `git rev-parse HEAD`, review the source, and then\ncopy only `skills/brainiall-diarized-transcription/` into the skills directory\ndocumented by your agent host. This keeps the install path auditable and avoids\nexecuting a third-party installer. The skill itself never asks for a key in chat\nor in a command argument.\n\nThe skill guides the agent through consent, local-file and size checks, a\ndedicated `BRAINIALL_API_KEY`, and a single non-retried API request. Create or\nmanage the required account through the\n[skill-specific setup link](https://app.brainiall.com/?utm_source=skills_sh&utm_medium=agent_skill&utm_campaign=diarized_transcription)\nand check the current terms before live use.\n\n## Caption QA helper\n\nThe repository also includes a dependency-free SRT/WebVTT structural check for CI or a local handoff:\n\n```bash\nnode skills/brainiall-diarized-transcription/scripts/caption-qa.mjs reviewed.vtt\n```\n\nIt checks the WebVTT header, cue timing, overlap, empty text, and SRT indexes. It does not assess semantic accuracy, rights, accessibility conformance, or payment, and it never sends media to BRAINIALL.\n\n## Postman collection\n\nImport [`postman/BRAINIALL-Diarized-Transcription.postman_collection.json`](postman/BRAINIALL-Diarized-Transcription.postman_collection.json) to test the same hosted API without installing a client. Before the request can run, set:\n\n- `brainiall_api_key` as a secret collection variable;\n- `confirmed_rights_and_consent` to the exact value `I CONFIRM`;\n- the `audio` form-data field to one authorized local recording.\n\nThe collection sends one request only and has no automatic retry. It exposes language, diarization, and output-format variables, and includes response checks for JSON plus word timestamps. A request may consume account credit; verify the current price and balance before sending it.\n\n## OpenAPI contract\n\n[`openapi/brainiall-diarized-transcription.openapi.json`](openapi/brainiall-diarized-transcription.openapi.json) is the canonical, machine-readable contract for the same multipart endpoint. Import it into Postman, Bruno, Insomnia, Swagger tooling, or an SDK generator. The document deliberately describes only the verified request and response fields; it does not claim OpenAI compatibility or expose an API key, file path, transcript, or account data.\n\nRead the hosted, search-indexable [BRAINIALL API reference](https://fasuizu-br.github.io/brainiall-transcription-skill/) when you want the contract rendered before importing it. The reference is read-only: it does not send media, store a key, or automatically retry a request.\n\nThe OpenAPI file cannot enforce recording rights or speaker consent. The caller must perform that check before selecting a file or sending a request, and must not automatically retry an ambiguous metered upload.\n\n### Import into an API client\n\n[Run the verified operation in Insomnia](https://app.insomnia.rest/run?operationId=transcribeAuthorizedRecording&specUrl=https%3A%2F%2Fraw.githubusercontent.com%2Ffasuizu-br%2Fbrainiall-transcription-skill%2Fmain%2Fopenapi%2Fbrainiall-diarized-transcription.openapi.json), or follow the dependency-free [client import guide](docs/API_CLIENT_IMPORTS.md) for Bruno, Hoppscotch, Yaak, Insomnia, and Kiota.\n\nEvery route imports the same public contract. It does not include an API key, recording, transcript, or automatic retry. Add a dedicated key locally and choose media only after confirming rights and any required speaker notice or consent.\n\n## Copyable quickstarts\n\nThree audited, single-send examples are available for teams that prefer code over an API client:\n\n- [`examples/curl/transcribe-once.sh`](examples/curl/transcribe-once.sh)\n- [`examples/python/transcribe_once.py`](examples/python/transcribe_once.py)\n- [`examples/javascript/transcribe-once.mjs`](examples/javascript/transcribe-once.mjs)\n\nAll three require the exact environment gate\n`BRAINIALL_CONFIRM=I_CONFIRM_RIGHTS_AND_COST`, a dedicated\n`BRAINIALL_API_KEY`, one local regular media file, and an explicit `pt` or `es`\nlanguage. They reject symlinks, files over 25 MB, existing output targets, and\nautomatic retries. Review the current account price and balance before running\nany example because a successful upload may consume credit.\n\n## Safety boundaries\n\n- One explicit local regular file; no remote URL, directory, glob, or symlink.\n- Brazilian Portuguese (`pt`) or Spanish (`es`), with a 25 MB limit.\n- Literal rights-and-consent confirmation before any request.\n- API key only through the environment; no transcript or upstream error body in logs.\n- No automatic retry of a potentially metered request.\n- New private output directory containing `transcript.json`, `transcript.srt`, and `transcript.vtt`.\n\n## Validate\n\n```bash\nnpm test\nnode scripts/validate-postman.mjs\nnode scripts/validate-openapi.mjs\nnode scripts/validate-integration-guide.mjs\nnode scripts/validate-quickstarts.mjs\nnode scripts/validate-pages.mjs\npython3 /path/to/skill-creator/scripts/quick_validate.py \\\n  skills/brainiall-diarized-transcription\n```\n\nThe test suite uses synthetic bytes and mocked responses. It does not need an\nAPI key, send media, or contact BRAINIALL.\n\nMIT licensed. BRAINIALL is responsible for this repository; it is not endorsed\nby Vercel or the maintainers of the skills CLI.\n\n## C104 integration blueprints\n\nOpen VSX, JetBrains, editorial, and OSS partner notes live under\n`integrations/c104/`. They are public recipes and publication gates only; they\ndo not claim marketplace approval, installation, partnership, or revenue.\n\n## C105 demand-capture blueprints\n\nThe `integrations/c105/` notes cover npm, PyPI, Hugging Face Spaces, Apify\nActors, referrals, and permission-first partner pilots. They are deliberately\nprovider-neutral recipes: publication requires the corporate account and the\nsurface's current review rules, while payment still requires a BRAINIALL\ncheckout, settlement, and reconciliation receipt.\n\n## C106 demand-capture blueprints\n\nThe `integrations/c106/` notes cover LinkedIn newsletters and Pages, Reddit,\nIndie Hackers, Medium, GitHub Discussions, Docker Hub, RapidAPI, and\nalternative storefront preflights. They are research and opt-in recipes, not\nclaims of publication, approval, installs, partnership, or revenue.\n\n## C108 demand-capture blueprints\n\nThe `integrations/c108/` notes cover app marketplaces, ecommerce caption\npilots, and Asana/Linear/Google Workspace workflow fixtures. They are\npermission-first research assets; no listing, install, approval, partnership\nor revenue is implied without a separate receipt.\n\n## C110 B2B demand fixtures\n\nThe `integrations/c110/` notes cover Teams call notes, a HubSpot RevOps\nhandoff, and a WordPress caption workflow. They are public, permission-first\nfixtures: no marketplace submission, tenant install, partnership, or revenue\nis implied without a separate receipt.\n\n## C107 demand-capture blueprints\n\nThe `integrations/c107/` notes cover registry/package preflights, Obsidian and\nZotero knowledge workflows, Chrome/Google Play store gates, and creator caption\nQA. They are local, permission-first recipes; no listing, install, partnership,\napproval or revenue is implied without a separate receipt.\n",
  "bytes": 7772,
  "sha": "0c5d8bdea9fc1c874ef69d9612e140fcf627e00bc919a3ad7d0553c6880a49d6",
  "repo_slug": "fasuizu-br/brainiall-transcription-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_fasuizu_br_brainiall_transcription_skill_1137d58a/readme"
}