Name: deepgram-python-text-intelligence
Rating: 75.2 (1 reviews)
Author: deepgram

deepgram-python-text-intelligence

Use when writing or reviewing Python code in this repo that calls Deepgram Text Intelligence / Read (`/v1/read`) for sentiment, summarization, topic detection, and intent recognition on text input. Covers `client.read.v1.text.analyze(...)` with body `text` or `url`. Use `deepgram-python-audio-intelligence` when the source is audio instead of text. Triggers include "read API", "text intelligence", "analyze text", "sentiment", "summarize text", "topics", "intents", "read.v1".

Quality

92%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured skill that provides immediately actionable code with good layered references. Its main weakness is redundancy around the `summarize` boolean-only constraint, which is stated three separate times across different sections. The content is otherwise lean, well-organized, and appropriately scoped for its purpose.

Suggestions

Consolidate the `summarize` boolean-only explanation into a single authoritative location (the gotchas section) and reference it briefly elsewhere, rather than repeating the full explanation three times.

Dimension	Reasoning	Score
Conciseness	Generally efficient but has some redundancy — the `summarize` boolean-only gotcha is explained three times (in the parameters table, gotchas section, and inline comment in quick start). The 'When to use this product' section and some explanatory prose could be tightened. The central product skills section at the end is boilerplate that adds little.	2 / 3
Actionability	Provides fully executable, copy-paste-ready code for both sync and async usage, a complete parameters table, concrete response access patterns, and specific file references. Claude can immediately use this to write working code.	3 / 3
Workflow Clarity	This is a single-shot REST API call skill, not a multi-step destructive workflow. The quick start is unambiguous, the async equivalent is clear, and the gotchas section effectively serves as a validation checklist for common mistakes. For this type of skill, the workflow clarity is appropriate.	3 / 3
Progressive Disclosure	Well-structured with a clear quick start, then layered detail (parameters table, response shape, gotchas). References to `reference.md`, external docs, and related skills (`deepgram-python-audio-intelligence`) are one level deep and clearly signaled. The API reference section provides a clean hierarchy of where to find more detail.	3 / 3
	Total	11 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly defines its scope (Deepgram Text Intelligence / Read API), lists specific capabilities (sentiment, summarization, topic detection, intent recognition), provides explicit trigger terms, and even disambiguates from a related sibling skill for audio. It uses proper third-person voice throughout and is concise yet comprehensive.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: sentiment analysis, summarization, topic detection, intent recognition, and specifies the exact API endpoint (`/v1/read`) and method (`client.read.v1.text.analyze(...)`) with input types (`text` or `url`).	3 / 3
Completeness	Clearly answers both 'what' (calls Deepgram Text Intelligence / Read for sentiment, summarization, topic detection, intent recognition) and 'when' (explicit 'Use when writing or reviewing Python code... that calls Deepgram Text Intelligence'). Also includes a disambiguation clause pointing to a sibling skill for audio sources.	3 / 3
Trigger Term Quality	Excellent coverage of natural trigger terms users would say: 'read API', 'text intelligence', 'analyze text', 'sentiment', 'summarize text', 'topics', 'intents', 'read.v1'. These are terms a developer would naturally use when working with this functionality.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive with a clear niche (Deepgram Read/text intelligence vs. audio intelligence), explicit disambiguation from the audio skill (`deepgram-python-audio-intelligence`), and specific API paths and method signatures that make it very unlikely to conflict with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: deepgram/deepgram-python-sdk
Commit: 3f7398a

Reviewed: 10 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.