Name: spotlightr
Rating: 56.00000000000001 (1 reviews)
Author: membranedev

spotlightr

Spotlightr integration. Manage Organizations, Users, Goals, Filters. Use when the user wants to interact with Spotlightr data.

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/spotlightr/SKILL.md

Quality

Content

50%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 operational half of this skill is strong — executable Membrane CLI commands with clear connection-state handling — but it is undermined by a ~280-line auto-generated noun dump that inflates the body and adds no value. Data-mutating operations also lack validation or verification steps.

Suggestions

Delete the 'Spotlightr Overview' bullet list (or move genuine Spotlightr-specific entities into a separate reference file); it is largely generic, duplicated padding.

Add a validation/verification checkpoint before destructive or batch operations (e.g., confirm the action's inputSchema, dry-run or confirm before proxy DELETE/PUT, verify the `output` field after running an action).

Replace placeholder values (CONNECTION_ID, QUERY, actionId) with a concrete end-to-end worked example so the guidance is fully copy-paste ready.

Dimension	Reasoning	Score
Conciseness	The body opens with ~280 lines of a generic noun list (Video, Hotspot, Button, Link, Create, Read, Update, Delete...) with many duplicates, which is a heavily padded section that wastes the context window; it is not a 1 because the operational CLI sections that follow are reasonably efficient and free of concept over-explanation.	2 / 5
Actionability	The CLI sections give concrete, copy-paste-ready commands (install, login, connection ensure, action list/run, request) plus a full proxy flag table, matching 'mostly executable guidance with minor gaps'; it is not a 5 because placeholders (CONNECTION_ID, QUERY, actionId) are left for the reader to resolve and the overview list adds no actionable value.	4 / 5
Workflow Clarity	The connection flow is clearly sequenced with state checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED) and a poll-again feedback loop, but running actions and proxy requests (which support destructive POST/PUT/DELETE and manage Users/Organizations) lack any validation or verification step, capping workflow clarity at 3 per the destructive/batch guideline.	3 / 5
Progressive Disclosure	The operational sections are organized under clear headers, but the giant inlined overview list is content that clearly belongs in a separate reference file or should be removed, and no external bundle references are signaled; it is not a 4 because nothing is split out despite the body being ~340 lines.	3 / 5
	Total	12 / 20 Passed

Description

78%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.

A concise, well-formed description that names a distinct third-party integration and provides an explicit 'Use when' trigger. It is slightly held back by a single generic action verb and a single generic trigger phrase rather than richer synonyms or concrete trigger variations.

Suggestions

Replace the repeated generic verb 'Manage' with distinct concrete actions (e.g., create, list, update, delete) tied to Spotlightr resources.

Expand the 'Use when' clause with concrete trigger phrases users would say, such as 'video marketing', 'Spotlightr videos', or 'manage Spotlightr organizations and users'.

Verify the listed resources (Organizations, Users, Goals, Filters) match Spotlightr's actual video-marketing domain to avoid misleading gaps.

Dimension	Reasoning	Score
Specificity	The description names the domain ('Spotlightr integration') and lists several concrete managed resources ('Manage Organizations, Users, Goals, Filters'), which matches the anchor listing several specific actions with minor gaps; it is not a 5 because the single verb 'Manage' lacks the action diversity of the top anchor.	4 / 5
Completeness	It answers both 'what' (Spotlightr integration; manage Organizations, Users, Goals, Filters) and 'when' ('Use when the user wants to interact with Spotlightr data'); it is not a 5 because the 'when' clause is a single generic trigger rather than multiple concrete trigger phrases.	4 / 5
Trigger Term Quality	It includes the natural brand keyword 'Spotlightr' and a usable trigger phrase ('interact with Spotlightr data'), giving good keyword coverage; it is not a 5 because synonyms like 'video', 'videos', or 'video marketing' that users might actually say are missing.	4 / 5
Distinctiveness Conflict Risk	Naming the specific third-party platform 'Spotlightr' gives it a clear niche with a distinct brand trigger and minimal conflict risk with other skills, matching the top anchor.	5 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
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/spotlightr/SKILL.md
Commit: f484c82

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.