CtrlK
BlogDocsLog inGet started
Tessl Logo

revai

Rev.ai integration. Manage data, records, and automate workflows. Use when the user wants to interact with Rev.ai data.

57

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/revai/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

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

The body is highly actionable with concrete CLI commands and a well-sequenced connection workflow that includes state-based validation checkpoints, though it carries minor verbose prose and inlines reference-style content that could be split out.

DimensionReasoningScore

Conciseness

The body is mostly lean with executable commands, tables, and brief notes; only minor prose like 'so you can focus on the integration logic rather than auth plumbing' could be trimmed; fits 'Efficient; minor instances of over-explanation that could be trimmed.'

4 / 5

Actionability

Concrete copy-paste commands cover the common cases (install, login, connection ensure, action list/run, proxy requests) with a documented flag table and JSON-input example; fits 'Fully executable; copy-paste ready code or commands.'

5 / 5

Workflow Clarity

The connection workflow is clearly sequenced with state-based checkpoints (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR) and a polling loop, but the destructive delete-job action is only listed in a table without validation guidance; fits 'Clear sequence with most checkpoints present; minor validation gaps.'

4 / 5

Progressive Disclosure

Content is organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) with no nested references, though the full action table and proxy flag reference are inlined rather than split into separate files; fits 'Good structure; most content is appropriately placed; minor organization gaps.'

4 / 5

Total

17

/

20

Passed

Description

50%Weight 40%Scale 1-5

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

The description correctly names the Rev.ai service and includes an explicit 'Use when' trigger, but it fails to mention Rev.ai's core capability (speech-to-text transcription) and relies on generic action verbs, weakening specificity and trigger-term quality.

Suggestions

Replace generic verbs with Rev.ai-specific actions, e.g. 'Submit transcription jobs, fetch transcripts and captions, and manage Rev.ai records.'

Add natural user trigger phrases such as 'transcribe audio', 'get captions', or 'convert speech to text'.

Tie the 'Use when' clause to concrete intents, e.g. 'Use when the user wants to transcribe audio/video or retrieve Rev.ai transcripts and captions.'

DimensionReasoningScore

Specificity

Phrases like 'Manage data, records, and automate workflows' name the Rev.ai domain but the actions are generic and omit what Rev.ai actually does (transcription, captions, transcripts); matches 'Names the domain but actions are minimal or generic.'

2 / 5

Completeness

Has both a 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Rev.ai data'), but the 'when' is generic rather than tied to concrete triggers; fits 'Has both what and when; when could be more explicit or specific.'

4 / 5

Trigger Term Quality

Keywords are 'Rev.ai', 'data', 'records', 'workflows' — generic terms missing the natural phrases users say ('transcribe', 'transcription', 'captions', 'audio to text'); fits 'One or two generic keywords; missing the natural phrases users say.'

2 / 5

Distinctiveness Conflict Risk

'Rev.ai integration' and 'interact with Rev.ai data' name a specific service, giving a clear niche with minimal conflict risk, though the generic 'manage data, records, automate workflows' adds slight overlap; fits 'Mostly distinct; minor overlap risk.'

4 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
membranedev/application-skills
Reviewed

Table of Contents

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.