CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ayrshare

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

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

Quality

Content

67%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 strongly on executable guidance: concrete CLI commands, a robust connection-state handling workflow with validation checkpoints, and clear proxy fallback. Its weaknesses are padding (a meaningless concept-list overview, marketing intro, and a redundant 'Popular actions' section) and small coherence issues like the dangling 'Step 2' reference.

Suggestions

Delete the 'Ayrshare Overview' bullet list and trim the marketing intro ('It's used by businesses and individuals...') — neither changes what the agent does.

Either populate 'Popular actions' with 2-3 real Ayrshare action examples (e.g. a post-to-networks run with actual --input JSON) or remove the section, since it currently just repeats the discovery command from 'Searching for actions'.

Fix the dangling references: 'skip to **Step 2**' points at no labeled step — either number the sections (1. Connect, 2. Discover, 3. Run) or reword to point at the actual heading.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete CLI commands, but the 'Ayrshare Overview' bullet list (Post ID, Platform, Date Range, User, API Key) conveys no actionable guidance, the intro includes marketing fluff ('It's used by businesses and individuals looking to streamline...'), and the 'Popular actions' heading merely repeats the discovery command from the previous section. Fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened').

3 / 5

Actionability

Commands are copy-paste ready throughout — install, login (including headless completion), connection ensure, action list/run with --input JSON, and a proxy request flag table — matching anchor 4. It falls short of anchor 5 because 'Popular actions' never demonstrates a real Ayrshare action (e.g. an actual post or analytics call with real input/output).

4 / 5

Workflow Clarity

The setup-to-execution sequence is clear and includes genuine validation checkpoints — --wait long-polling, an explicit connection state machine (READY / CLIENT_ACTION_REQUIRED with clientAction fields / CONFIGURATION_ERROR with error inspection) — matching anchor 4. A minor gap keeps it below anchor 5: the instruction 'skip to **Step 2**' references a numbered step that exists nowhere as a heading.

4 / 5

Progressive Disclosure

A single well-organized file with clear section headers and appropriately concise inline content; no bundle files exist to reference. It sits at anchor 4 rather than 5 because the ~140-line body (over the 50-line simple-skill threshold) inlines material such as the proxy flag table and the full clientAction schema that could live in one-level-deep reference files.

4 / 5

Total

15

/

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 benefits from a distinctive product name and includes an explicit 'Use when' clause, but its capability statements are generic ('manage data, records, and automate workflows') and it omits all natural trigger language around social media. It reads like a template description with the domain swapped in.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete Ayrshare capabilities such as 'Post to major social networks, schedule posts, pull analytics' so the 'what' is specific.

Add natural trigger phrases users would actually say, e.g. 'Use when the user mentions Ayrshare, posting to social media, scheduling social posts, or pulling social media analytics'.

Tighten the 'when' clause beyond the circular 'interact with Ayrshare data' by naming the concrete scenarios (posting, analytics, platform management) the skill covers.

DimensionReasoningScore

Specificity

The description names the domain ('Ayrshare integration') but its actions — 'Manage data, records, and automate workflows' — are generic rather than concrete, matching the anchor 'names the domain but actions are minimal or generic'. It is below anchor 3 because it lists no concrete action comparable to 'extracts content'.

2 / 5

Completeness

It has both a 'what' ('Ayrshare integration. Manage data, records, and automate workflows.') and an explicit 'when' ('Use when the user wants to interact with Ayrshare data'), but the 'when' could be more specific and the 'what' is vague, matching anchor 4 rather than the fully concrete anchor 5.

4 / 5

Trigger Term Quality

The only substantive keyword is the proper noun 'Ayrshare'; the description misses every natural phrase a user would say ('post to social media', 'schedule posts', 'social networks', 'analytics'), fitting anchor 2 ('one or two generic keywords; missing the natural phrases users say').

2 / 5

Distinctiveness Conflict Risk

'Ayrshare' anchors a clear niche with minimal conflict risk, but the generic phrases 'manage data, records, and automate workflows' create minor overlap risk with generic data-management skills, matching anchor 4 ('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.

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/ayrshare/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.