CtrlK
BlogDocsLog inGet started
Tessl Logo

sitespeakai

SiteSpeakAI integration. Manage Organizations. Use when the user wants to interact with SiteSpeakAI data.

59

Quality

68%

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/sitespeakai/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is highly actionable with executable commands throughout and a clear connect-ready-run workflow that includes polling and state-based validation. Its main weakness is conciseness: a marketing-style intro and motivational asides add tokens without operational value, and a dangling 'Step 2' reference slightly muddies the sequence.

Suggestions

Trim the marketing intro to a one-line purpose statement; drop 'It's used by website owners, marketers, and customer service teams...' and 'so you can focus on the integration logic rather than auth plumbing', which add no executable value.

Fix the broken step numbering: either label an explicit 'Step 2' header or remove the 'skip to Step 2' reference so the workflow sequence is unambiguous.

Merge the thin 'Popular actions' section into 'Searching for actions' to remove the duplicated discovery command and tighten the document.

DimensionReasoningScore

Conciseness

The bulk is concrete commands, but it includes unnecessary explanation such as the marketing-style intro ('It's used by website owners, marketers, and customer service teams...') and phrases like 'so you can focus on the integration logic rather than auth plumbing', fitting 'mostly efficient but includes some unnecessary explanation'. It is not a 4 because the padded intro and motivational asides are more than minor, and not a 2 because the operational sections are genuinely tight.

3 / 5

Actionability

It provides fully executable, copy-paste-ready commands for the whole workflow (install, login, connection ensure, connection get --wait, action list, action run, request proxy) with clearly marked runtime placeholders and a flags table, matching 'fully executable; copy-paste ready commands; specific examples cover the common cases'. It is not a 4 because the common cases are concretely covered rather than having minor gaps.

5 / 5

Workflow Clarity

The connect-to-ready flow has explicit validation checkpoints (state READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and feedback loops (poll until not BUILDING; re-poll after the user authenticates), matching 'clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because the prose refers to 'Step 2' which is never labeled, leaving the numbering broken, and there is no consolidated checklist.

4 / 5

Progressive Disclosure

The body is organized into clear, navigable sections (Overview, Install, Authentication, Connecting, Searching, Running actions, Proxy, Best practices) with no nested file references and content appropriately kept inline for a cohesive integration guide, matching 'good structure; most content appropriately placed; minor organization gaps'. It is not a 5 because there is mild redundancy (the 'Popular actions' section repeats the 'Searching for actions' discovery command) and the simple-skill 5 exception is for skills under 50 lines.

4 / 5

Total

16

/

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 is third-person, includes an explicit 'Use when...' trigger, and is tied to a distinct brand, but it is thin on concrete capabilities and natural-sounding trigger synonyms. It answers both 'what' and 'when' adequately without over-claiming.

Suggestions

Add 1-2 more concrete capabilities beyond 'Manage Organizations' (e.g., 'configure website chatbots, manage training data files, and invite users') to lift specificity.

Include natural trigger synonyms users would say, such as 'chatbot', 'website chatbot', or 'customer support automation', so the skill surfaces for phrasings beyond the product name.

Tighten the 'when' clause to concrete triggers, e.g. 'Use when the user wants to manage SiteSpeakAI chatbots, organizations, users, or training data.'

DimensionReasoningScore

Specificity

It names the domain ('SiteSpeakAI integration') and one concrete action ('Manage Organizations'), but offers no further concrete operations, matching 'names domain and 1-2 concrete actions, but not comprehensive'. It is not a 2 because a real action is named beyond the domain, and not a 4 because coverage is thin (the body reveals chatbots, training data, users, files are also handled but go unmentioned).

3 / 5

Completeness

Both 'what' ('SiteSpeakAI integration. Manage Organizations.') and 'when' ('Use when the user wants to interact with SiteSpeakAI data.') are explicitly present, matching 'has both what and when; when could be more explicit or specific'. It is not capped at 3 because an explicit 'Use when...' clause exists, and not a 5 because the 'when' is generic ('interact with SiteSpeakAI data') rather than listing concrete trigger phrases.

4 / 5

Trigger Term Quality

The product name 'SiteSpeakAI' is a natural keyword and 'Use when the user wants to interact with SiteSpeakAI data' gives a trigger, but it omits common variations a user would actually say ('chatbot', 'website chatbot', 'customer support', 'lead generation'), fitting 'some relevant keywords but missing common variations'. It is not a 4 because the natural synonyms are absent, and not a 2 because a genuine natural term (the product name) is present.

3 / 5

Distinctiveness Conflict Risk

The unique brand 'SiteSpeakAI' gives a clear, distinct niche with minimal conflict risk, but the generic 'Manage Organizations' action could overlap with org-management in other skills, fitting 'mostly distinct; minor overlap risk'. It is not a 5 because 'Manage Organizations' is a generic action shared across many skills, and not a 3 because the brand-specific trigger keeps it clearly distinguishable.

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.