Skip to content

feat: add gladia-using-cli skill#13

Merged
karamouche merged 8 commits into
mainfrom
feat/gladia-cli-skill
Jul 9, 2026
Merged

feat: add gladia-using-cli skill#13
karamouche merged 8 commits into
mainfrom
feat/gladia-cli-skill

Conversation

@karamouche

@karamouche karamouche commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator
  • Added a new skill to teach to an agent how to use the gladia CLI

Summary by CodeRabbit

  • Documentation
    • Added new guidance for using the terminal-based transcription workflow.
    • Clarified when to use this option versus live transcription, app-based integration, or audio intelligence features.
    • Expanded setup notes, authentication details, available commands, and common transcription options.
    • Updated existing reference pages to better route users to the right transcription approach and related help content.

@karamouche karamouche requested a review from egenthon-cmd June 26, 2026 02:13
@coderabbitai

coderabbitai Bot commented Jun 26, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8ec92879-abed-49e9-8131-2c970306bb40

📥 Commits

Reviewing files that changed from the base of the PR and between af228ba and 12e4aeb.

📒 Files selected for processing (1)
  • plugins/gladia/skills/gladia-using-cli/SKILL.md

📝 Walkthrough

Walkthrough

This PR adds a new Gladia CLI skill page documenting terminal-based transcription workflows, authentication, commands, flags, and agent guidance. It also adds a CLI-vs-SDK routing reference, and updates the plugin README and related SDK/pre-recorded transcription skill docs with cross-links to the new CLI skill.

Changes

Gladia CLI documentation updates

Layer / File(s) Summary
Skill entry and setup
plugins/gladia/README.md, plugins/gladia/skills/gladia-using-cli/SKILL.md
Adds a gladia-using-cli row to the README skills table and creates the new CLI skill page with overview, when-to-use/not-use guidance, references, and setup/authentication instructions.
Flags and examples
plugins/gladia/skills/gladia-using-cli/SKILL.md
Documents transcription flags, output-format and language behavior, example commands, common mistakes, the CLI-vs-SDK routing matrix, and the transcribe-then-Q&A agent workflow.
Routing matrix and backlinks
plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md, plugins/gladia/skills/gladia-sdk-integration/SKILL.md, plugins/gladia/skills/gladia-pre-recorded-transcription/SKILL.md
Adds the CLI-vs-SDK reference page mapping transcription modes, flags, and output formats to SDK equivalents, and updates SDK integration and pre-recorded transcription docs with links to the new CLI skill.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: adding the new Gladia CLI skill.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/gladia-cli-skill

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (2)
plugins/gladia/skills/gladia-using-cli/SKILL.md (2)

42-42: 🔒 Security & Privacy | 🔵 Trivial | 💤 Low value

Consider adding checksum verification to the install script.

The curl | sh pattern is convenient but bypasses package managers and code review. For a trusted official repository this is acceptable, but consider adding a note about verifying the install script checksum or using a package manager when available. Not blocking given the official source.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/gladia/skills/gladia-using-cli/SKILL.md` at line 42, The install
command in the Gladia CLI skill uses a direct curl-to-shell pattern without any
verification guidance. Update the SKILL.md instructions around the install step
to mention verifying the install script checksum or preferring a package manager
when available, and keep the guidance tied to the current `curl -fsSL ... | sh`
install flow so users have a safer alternative.

27-36: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Add gladia-sdk-integration to the References section.

The References section is missing a link to ../gladia-sdk-integration/SKILL.md. Per the guideline, skills that generate code should cross-reference sdk-integration for setup, and the References section is the standard location for skill-to-skill links. This is already done in the callout and "When NOT to Use," but adding it to References ensures agents discover it at load time.

 - ./references/cli-vs-sdk.md -- Full feature matrix: CLI flag vs SDK skill routing
 - ../gladia-pre-recorded-transcription/SKILL.md -- SDK pre-recorded workflow and options
 - ../gladia-audio-intelligence/SKILL.md -- Addons beyond CLI flags
+- ../gladia-sdk-integration/SKILL.md -- SDK setup and initialization
 - ../gladia-troubleshooting/SKILL.md -- API key, upload, and polling errors
 - [gladia-cli repository](https://github.com/gladiaio/gladia-cli/)
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/gladia/skills/gladia-using-cli/SKILL.md` around lines 27 - 36, The
References section in gladia-using-cli is missing the cross-link to the SDK
setup skill, so add `../gladia-sdk-integration/SKILL.md` alongside the existing
skill references. Update the References list in the `SKILL.md` for
`gladia-using-cli` so agents can discover `gladia-sdk-integration` at load time,
matching the existing pattern used by the callout and “When NOT to Use”
guidance.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/gladia/skills/gladia-using-cli/SKILL.md`:
- Line 73: The `--model` flag description in the Gladia CLI skill has a
duplicated model name; update the table entry in `SKILL.md` so the second listed
option in the `--model` row uses the correct value from the CLI docs,
`solaria-3`, instead of repeating `solaria-1`.

---

Nitpick comments:
In `@plugins/gladia/skills/gladia-using-cli/SKILL.md`:
- Line 42: The install command in the Gladia CLI skill uses a direct
curl-to-shell pattern without any verification guidance. Update the SKILL.md
instructions around the install step to mention verifying the install script
checksum or preferring a package manager when available, and keep the guidance
tied to the current `curl -fsSL ... | sh` install flow so users have a safer
alternative.
- Around line 27-36: The References section in gladia-using-cli is missing the
cross-link to the SDK setup skill, so add `../gladia-sdk-integration/SKILL.md`
alongside the existing skill references. Update the References list in the
`SKILL.md` for `gladia-using-cli` so agents can discover
`gladia-sdk-integration` at load time, matching the existing pattern used by the
callout and “When NOT to Use” guidance.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7db01cc5-d49f-4fdf-a375-16e2b16743fd

📥 Commits

Reviewing files that changed from the base of the PR and between 5f0cf82 and cec438a.

📒 Files selected for processing (5)
  • plugins/gladia/README.md
  • plugins/gladia/skills/gladia-pre-recorded-transcription/SKILL.md
  • plugins/gladia/skills/gladia-sdk-integration/SKILL.md
  • plugins/gladia/skills/gladia-using-cli/SKILL.md
  • plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md

Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md Outdated
@karamouche karamouche force-pushed the feat/gladia-cli-skill branch from cec438a to 9047c1b Compare June 26, 2026 20:06

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
plugins/gladia/skills/gladia-using-cli/SKILL.md (1)

39-43: 🔒 Security & Privacy | 🔵 Trivial | ⚡ Quick win

Add checksum verification or safer install alternative.

The curl … | sh pattern bypasses code review of the executed script. Consider adding a note to verify the release checksum or prefer a package-manager install when available.

  ```bash
- curl -fsSL https://github.com/gladiaio/gladia-cli/releases/latest/download/install.sh | sh
+ # Verify checksum before executing (see releases page for SHA256)
+ curl -fsSL https://github.com/gladiaio/gladia-cli/releases/latest/download/install.sh -o install.sh
+ sh install.sh

Or document `pip install gladia-cli` / `npm install -g gladia-cli` if those are official options.

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @plugins/gladia/skills/gladia-using-cli/SKILL.md around lines 39 - 43, The
install instructions currently use a direct curl-to-shell pattern, so update the
Gladia CLI setup guidance to avoid executing an unchecked script. In the
SKILL.md install section, revise the shell install example to download the
script first and add a checksum verification note, or replace it with an
official package-manager install path if one exists. Keep the change localized
to the install snippet and surrounding guidance so users can safely install
gladia-cli.


</details>

<!-- cr-comment:v1:92925ecd3068a0e43dc43dec -->

</blockquote></details>

</blockquote></details>

<details>
<summary>🤖 Prompt for all review comments with AI agents</summary>

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @plugins/gladia/skills/gladia-using-cli/SKILL.md:

  • Around line 39-43: The install instructions currently use a direct
    curl-to-shell pattern, so update the Gladia CLI setup guidance to avoid
    executing an unchecked script. In the SKILL.md install section, revise the shell
    install example to download the script first and add a checksum verification
    note, or replace it with an official package-manager install path if one exists.
    Keep the change localized to the install snippet and surrounding guidance so
    users can safely install gladia-cli.

</details>

---

<details>
<summary>ℹ️ Review info</summary>

<details>
<summary>⚙️ Run configuration</summary>

**Configuration used**: defaults

**Review profile**: CHILL

**Plan**: Pro

**Run ID**: `d571dda9-5160-4082-a6da-050c0d2dedf7`

</details>

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between cec438ad5eb6efccfe42fbb57eea8a1fa8786ea1 and 9047c1b6e89a067967c39102b7faddaec0184637.

</details>

<details>
<summary>📒 Files selected for processing (5)</summary>

* `plugins/gladia/README.md`
* `plugins/gladia/skills/gladia-pre-recorded-transcription/SKILL.md`
* `plugins/gladia/skills/gladia-sdk-integration/SKILL.md`
* `plugins/gladia/skills/gladia-using-cli/SKILL.md`
* `plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md`

</details>

<details>
<summary>✅ Files skipped from review due to trivial changes (4)</summary>

* plugins/gladia/README.md
* plugins/gladia/skills/gladia-pre-recorded-transcription/SKILL.md
* plugins/gladia/skills/gladia-sdk-integration/SKILL.md
* plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md

</details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

Comment thread plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md
Comment thread plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md Outdated
Comment thread plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md Outdated
Comment thread plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md Outdated
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
@karamouche karamouche requested a review from egenthon-cmd June 29, 2026 16:32
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md
egenthon-cmd
egenthon-cmd previously approved these changes Jul 6, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/gladia/skills/gladia-using-cli/SKILL.md`:
- Around line 96-103: The summary table in SKILL.md is out of sync with the CLI
model options because the Model choice row in the table only mentions solaria-1
even though the earlier flag table also includes solaria-3. Update the Model
choice entry in the summary table so it mirrors the available model options
exactly, using the same wording and identifiers as the CLI flag section to keep
both references aligned.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c5c450c9-f931-4c4a-9668-e999508953d5

📥 Commits

Reviewing files that changed from the base of the PR and between 3263aff and af228ba.

📒 Files selected for processing (2)
  • plugins/gladia/skills/gladia-using-cli/SKILL.md
  • plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md
✅ Files skipped from review due to trivial changes (1)
  • plugins/gladia/skills/gladia-using-cli/references/cli-vs-sdk.md

Comment thread plugins/gladia/skills/gladia-using-cli/SKILL.md Outdated
@karamouche karamouche requested a review from egenthon-cmd July 7, 2026 15:01
@karamouche karamouche merged commit 9e3441a into main Jul 9, 2026
3 checks passed
@karamouche karamouche deleted the feat/gladia-cli-skill branch July 9, 2026 15:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants