CtrlK
BlogDocsLog inGet started
Tessl Logo

amara

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

61

Quality

72%

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/amara/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 a lean, highly actionable CLI integration guide with concrete copy-paste commands and a well-sequenced connection workflow including state-based validation checkpoints. Its main gaps are placeholder 'No description' entries in the actions table and a lack of validation guidance around the destructive actions it exposes.

Suggestions

Remove or replace the 'No description' placeholders in the Popular actions table with one-line action summaries.

Trim the opening paragraph explaining what Amara is, since Claude already knows the platform.

Add a brief validation/safety note before destructive actions like delete-video and delete-subtitles (e.g. confirm the target ID before running).

DimensionReasoningScore

Conciseness

The body is dominated by lean, executable command blocks, with only minor over-explanation such as the opening paragraph describing what Amara is and the 'Popular actions' table whose descriptions all read 'No description', matching the 'efficient; minor instances of over-explanation that could be trimmed' anchor. Not a 5 because the introductory Amara explainer and placeholder descriptions add padding; not a 3 because the bulk is tight and command-focused.

4 / 5

Actionability

Provides copy-paste-ready commands for every common case (install, login, connection ensure, action list/run with JSON input, proxy requests with flag tables), matching the 'fully executable; copy-paste ready commands covering common cases' anchor. Not a 4 because examples are complete and concrete rather than having gaps.

5 / 5

Workflow Clarity

The connection workflow is clearly sequenced with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a poll-handle-poll feedback loop, matching the 'clear sequence with most checkpoints present; minor validation gaps' anchor. Not a 5 because destructive actions (Delete Video, Delete Subtitles) are listed without pre/post validation guidance; not a 3 because the core connection workflow has explicit validation checkpoints.

4 / 5

Progressive Disclosure

Content is organized into well-labeled sections (Overview, Working with Amara, Searching/Running actions, Proxy, Best practices) in a single file with no nested references, matching the 'good structure; most content appropriately placed; minor organization gaps' anchor. Not a 5 because the Popular actions table is sizable inline material that could live in a separate reference; not a 3 because structure is clear and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

62%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 answers both what and when with an explicit trigger clause and uses appropriate third-person voice, but relies on generic verbs (manage, automate) rather than concrete Amara-specific actions and omits natural subtitling/translation trigger terms.

Suggestions

Replace generic verbs with concrete Amara actions, e.g. 'Create and manage videos, subtitle languages, and team projects'.

Add natural trigger terms users would say, such as 'subtitles', 'captions', 'translation', or 'video subtitles'.

Tighten the 'when' clause to concrete triggers, e.g. 'Use when the user wants to add or retrieve Amara subtitles, videos, or team data'.

DimensionReasoningScore

Specificity

Names the Amara domain and a few actions ('Manage data, records, and automate workflows'), but the actions are generic rather than concrete like extracting or creating specific entities, matching the 'names domain and 1-2 concrete actions, not comprehensive' anchor. Not a 4 because no specific concrete operations are enumerated; not a 2 because more than a single minimal action is named.

3 / 5

Completeness

Provides a 'what' ('Manage data, records, and automate workflows') and an explicit 'when' ('Use when the user wants to interact with Amara data'), but the trigger is generic rather than concrete, matching the 'has both what and when; when could be more explicit' anchor. Not a 5 because the when lacks concrete trigger phrases; not a 3 because an explicit Use-when clause is present.

4 / 5

Trigger Term Quality

Includes the distinctive term 'Amara' plus 'data' and 'interact with Amara data', but lacks common variations or synonyms (e.g. subtitles, captions, translation, videos), matching the 'some relevant keywords but missing common variations' anchor. Not a 4 because natural user phrasings around subtitling/translation are absent; not a 2 because the Amara keyword is genuinely natural.

3 / 5

Distinctiveness Conflict Risk

The 'Amara' name gives it a clear niche with low conflict risk, but the surrounding 'data, records, workflows' language is generic and could overlap with other data-integration skills, matching the 'mostly distinct; minor overlap risk' anchor. Not a 5 because the triggers are not crisply distinctive; not a 3 because Amara is a specific, identifiable product.

4 / 5

Total

14

/

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.