CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alttextai

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

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

63%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 delivers a concrete, executable workflow for connecting to AltText.ai and invoking actions through the Membrane CLI, with genuinely good connection-state handling and error checkpoints. Its weaknesses are padding (marketing intro, filler lines), an actions table with empty descriptions and no IDs, and a dangling "Step 2" reference that breaks navigation, plus heavy inlining of Membrane-generic boilerplate.

Suggestions

Delete the filler line "When to use which actions: Use action names and parameters as needed." and trim the marketing-style intro paragraph to a single sentence.

Fix the dangling "skip to **Step 2**" references — either number the subsequent sections or reword to "continue to Searching for actions".

Populate the empty Description column of the Popular actions table and show how to obtain an actionId (e.g. via `membrane action list --intent`) so `membrane action run` examples are directly usable.

DimensionReasoningScore

Conciseness

The body is mostly command-focused, but contains several padded passages: the filler line "When to use which actions: Use action names and parameters as needed.", the marketing intro "It's used by website owners, bloggers, and e-commerce businesses to optimize their online content", and commentary like "so you can focus on the integration logic rather than auth plumbing". Mostly efficient but with unnecessary explanation that could be tightened — anchor 3, not 4, because the padding is more than minor.

3 / 5

Actionability

Concrete, executable bash commands cover the full path: install, login (including headless completion), connection ensure, polling, action search/run with JSON input, and proxied API requests with a flags table. Score 4 rather than 5 because the Popular actions table has an empty Description column and provides no actionIds, and "skip to **Step 2**" references a step that does not exist in the document.

4 / 5

Workflow Clarity

The sequence — install CLI, authenticate, connect, poll for readiness, search actions, run, proxy fallback — is clear and includes explicit state checkpoints (READY, BUILDING, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) with a re-poll loop after user action. Score 4 rather than 5 because the dangling "Step 2" reference and unnumbered sections slightly break navigation; above 3 because validation checkpoints are explicit, not implicit.

4 / 5

Progressive Disclosure

This is a single-file skill with no references/, scripts/, or assets/ directories and reasonably organized section headers. However, at ~145 lines it inlines Membrane-generic operational detail (CLI install, login, connection state handling, proxy flags) that is shared boilerplate across integration skills, and has organization gaps: an empty Description column in the actions table and a phantom "Step 2" reference. Some structure but could be better organized — anchor 3, not 4, due to these gaps; not 2 because the document is clearly sectioned and navigable, not a wall of text.

3 / 5

Total

14

/

20

Passed

Description

46%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 names the integration and includes an explicit "Use when" clause, but its action list is generic SaaS boilerplate that omits what AltText.ai actually does (generating alt text for images). Natural trigger terms like "alt text", "image descriptions", or "accessibility" are entirely absent, weakening both discoverability and distinctiveness.

Suggestions

Replace "Manage data, records, and automate workflows" with AltText.ai-specific capabilities, e.g. "Generate alt text for images, scrape pages for images, and search image libraries".

Add natural trigger terms to the when-clause: "Use when the user mentions alt text, image descriptions or captions, image accessibility, or SEO for images".

Mention the concrete objects users work with (images, pages, projects) instead of the generic "data" and "records" to reduce overlap with other integration skills.

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" are generic actions that could describe any SaaS integration, and the description never mentions alt text, images, SEO, or accessibility — the actual capabilities of AltText.ai. It names the domain but the actions are minimal or generic, matching anchor 2 rather than 3 because no concrete action is listed.

2 / 5

Completeness

Both parts are present: the what ("AltText.ai integration. Manage data, records, and automate workflows") and an explicit when ("Use when the user wants to interact with AltText.ai data"). Score 4 rather than 5 because the when-clause is circular and lacks concrete trigger phrases, and above 3 because the when is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

The only keywords are the brand name plus generic terms ("data", "records", "workflows"); the natural phrases users would say — "alt text", "image descriptions", "accessibility", "SEO" — are all missing. This matches anchor 2: one or two generic keywords while missing the natural phrases users actually say.

2 / 5

Distinctiveness Conflict Risk

"AltText.ai" is a distinct app name, but "Manage data, records, and automate workflows" is boilerplate that overlaps with virtually every app-integration skill, so generic requests could trigger the wrong skill. Somewhat specific but overlapping with similar skills — anchor 3, not 4, due to the high overlap risk from the generic action phrasing.

3 / 5

Total

11

/

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.

Validation — 15 / 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

Path

skills/alttextai/SKILL.md

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.