Name: simplekpi
Rating: 64 (1 reviews)
Author: membranedev

simplekpi

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

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

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 comprehensive executable command coverage and a clear connection-state workflow. It loses points to marketing-fluff intro padding and a redundant "Popular actions" section that overlaps the action-discovery guidance.

Suggestions

Trim the marketing intro and rationale phrases (e.g. "so you can focus on the integration logic rather than auth plumbing") to reduce token overhead.

Merge the redundant "Popular actions" section into "Searching for actions" / "Running actions" to remove overlap and fix the dangling "skip to Step 2" reference with a labeled Step 2 header.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with concrete commands, but includes trimmable padding such as the marketing intro ("helps businesses monitor performance, identify trends, and make data-driven decisions") and phrases like "so you can focus on the integration logic rather than auth plumbing".	3 / 5
Actionability	Provides copy-paste-ready executable commands for every common case (install, login, connection ensure/get with --wait, action list/run, request proxy) plus a complete flag table, fully covering the workflow.	5 / 5
Workflow Clarity	The connection flow has a clear sequence with explicit state checkpoints (READY, CLIENT_ACTION_REQUIRED, CONFIGURATION_ERROR) and a poll feedback loop, but references like "skip to Step 2" do not map to a labeled Step 2 header and the section numbering ("1b") is loose.	4 / 5
Progressive Disclosure	Content is well-organized into logical sections with no nested references, but the "Popular actions" section substantially overlaps "Searching for actions" and the ~140-line body has minor organization gaps despite having no external bundle files to disclose.	4 / 5
	Total	16 / 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.

The description is product-specific and clearly answers both what and when, with strong distinctiveness. It is held back from a top score by a single generic verb and a trigger clause that lacks natural synonyms like KPIs, metrics, or reporting.

Suggestions

Replace the repeated generic verb "Manage" with varied concrete actions per resource (e.g., create/update users, query goals, list projects).

Expand the "Use when" trigger with natural synonyms users actually say, e.g. "Use when the user wants to track KPIs, view metrics, or manage SimpleKPI reporting data."

Dimension	Reasoning	Score
Specificity	Lists several concrete managed entities ("Manage Users, Organizations, Goals, Projects, Pipelines, Filters") which name the domain and multiple resources, but the single repeated verb "Manage" leaves minor gaps in differentiated action coverage rather than varied concrete verbs.	4 / 5
Completeness	Explicitly answers both what ("SimpleKPI integration. Manage Users, Organizations, Goals, Projects, Pipelines, Filters.") and when ("Use when the user wants to interact with SimpleKPI data"), but the when clause is generic and lacks concrete varied trigger phrases.	4 / 5
Trigger Term Quality	Includes the product name "SimpleKPI" and the trigger phrase "Use when the user wants to interact with SimpleKPI data", but omits common natural synonyms users might say such as KPIs, metrics, tracking, or reporting.	4 / 5
Distinctiveness Conflict Risk	The product-specific name "SimpleKPI" and its named resources carve a clear niche with distinct triggers and minimal conflict risk against unrelated skills.	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/simplekpi/SKILL.md
Commit: f484c82

Reviewed: ~22 hours 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.