CtrlK
BlogDocsLog inGet started
Tessl Logo

idealspot

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

62

Quality

74%

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/idealspot/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 strong, actionable CLI integration guide with executable commands, a clear connection state-machine, and feedback loops for auth recovery. Its main weaknesses are minor prose padding and a self-contained structure that does not split larger reference material into separate files.

DimensionReasoningScore

Conciseness

The body is mostly efficient with concrete commands throughout, but contains minor padding such as the marketing-style intro ('helps businesses make better decisions...') and 'so you can focus on the integration logic rather than auth plumbing'. This matches the 'efficient; minor instances of over-explanation that could be trimmed' anchor, above 3 because the bulk is lean and command-driven.

4 / 5

Actionability

Commands are fully executable and copy-paste ready across the common cases (install, login, connection ensure, action list/run, request proxy) plus concrete flag tables. This matches the top anchor 'fully executable; copy-paste ready; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The connection setup is a clear state-machine sequence with explicit validation (state checks, --wait polling) and a feedback loop (re-poll after the user completes clientAction), but 'skip to Step 2' references an unlabeled target and the doc blends workflow with reference material. This matches anchor 4 ('clear sequence with most checkpoints; minor validation gaps').

4 / 5

Progressive Disclosure

The body is well-organized into clear sections (Install, Authentication, Connecting, Searching, Running, Proxy, Best practices) and is self-contained with no nested references; the inline action and flag tables are modest in size. This matches anchor 4 ('good structure; most content appropriately placed; minor organization gaps'); it is not 5 because no detailed reference is split out despite exceeding 50 lines.

4 / 5

Total

17

/

20

Passed

Description

66%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 includes both a 'what' and an explicit 'Use when' trigger tied to a distinct named product, but it is thin: only one concrete action and no trigger synonyms beyond 'IdealSpot'. It is distinguishable yet under-specified on capability coverage.

Suggestions

Replace 'Manage Organizations' with several concrete actions that reflect IdealSpot's actual surface (e.g., query demographics, get traffic counts, fetch road segments, list insights).

Add natural trigger synonyms users might say, such as 'location analytics', 'site selection', 'demographic data', or 'traffic counts'.

Tighten the 'when' clause to name concrete intents, e.g., 'Use when the user wants location demographics, traffic counts, or site-selection data from IdealSpot.'

DimensionReasoningScore

Specificity

Names the domain ('IdealSpot integration') and one concrete action ('Manage Organizations') but coverage is not comprehensive, matching the anchor for 'domain and 1-2 concrete actions'. It is above 2 because 'Manage Organizations' is a real action rather than generic processing, but below 4 since only a single action is named.

3 / 5

Completeness

Both a 'what' ('IdealSpot integration. Manage Organizations.') and an explicit 'when' ('Use when the user wants to interact with IdealSpot data.') are present, but the when is generic. This matches anchor 4 ('both what and when; when could be more explicit'). It is above 3 because the 'Use when' trigger guidance is explicit, not merely implied.

4 / 5

Trigger Term Quality

The only natural keyword is 'IdealSpot' (and 'IdealSpot data'); common variations or synonyms a user might say are absent, fitting the 'some relevant keywords but missing variations' anchor. It is not 4 because keyword coverage is thin rather than merely missing a few.

3 / 5

Distinctiveness Conflict Risk

Naming the specific product 'IdealSpot' gives a clear niche with distinct triggers and minimal conflict risk with other skills, matching the top anchor. It is not below 5 because the product name is unambiguous and unlikely to fire for unrelated skills.

5 / 5

Total

15

/

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.