kpi-definition-helper
Kpi Definition Helper - Auto-activating skill for Data Analytics. Triggers on: kpi definition helper, kpi definition helper Part of the Data Analytics skill category.
Install with Tessl CLI
npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill kpi-definition-helperOverall
score
17%
Does it follow best practices?
Validation for skill structure
Activation
0%This is an extremely weak skill description that provides almost no useful information for skill selection. It consists only of boilerplate metadata (skill name, category) without any concrete capabilities, use cases, or natural trigger terms. Claude would have no meaningful basis to choose this skill over others.
Suggestions
Add specific concrete actions the skill performs, e.g., 'Helps define, document, and validate Key Performance Indicators (KPIs) including formulas, thresholds, data sources, and measurement frequency.'
Include a 'Use when...' clause with natural trigger terms like 'Use when the user asks about KPIs, metrics, performance indicators, business measures, or needs help defining what to track.'
Add common variations of terminology users might use: 'KPI', 'key performance indicator', 'metrics', 'OKRs', 'success measures', 'tracking goals'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions - only the name 'Kpi Definition Helper' and category 'Data Analytics'. There are no specific capabilities like 'creates KPI formulas', 'validates metrics', or 'generates dashboards'. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond the vague name, and has no 'Use when...' clause or equivalent guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | The only trigger terms listed are 'kpi definition helper' repeated twice, which is the skill name itself rather than natural user language. Missing obvious terms like 'KPI', 'metrics', 'performance indicators', 'measure', 'dashboard'. | 1 / 3 |
Distinctiveness Conflict Risk | The generic 'Data Analytics' category and lack of specific triggers means this could easily conflict with any other analytics-related skill. Nothing distinguishes it from general data analysis tools. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
0%This skill is a placeholder template with no actual content. It describes capabilities it doesn't deliver and provides zero actionable guidance on KPI definition. The entire body consists of generic boilerplate that could apply to any skill topic.
Suggestions
Add concrete KPI definition methodology: what makes a good KPI (SMART criteria), common KPI categories, and how to align KPIs with business objectives
Include executable SQL examples for calculating common KPIs (e.g., customer retention rate, revenue growth, conversion rate)
Provide a clear workflow: 1) Identify business objective, 2) Define measurable metric, 3) Write SQL query, 4) Validate against sample data, 5) Document threshold/targets
Add specific examples showing input (business question) and output (KPI definition with SQL implementation)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic boilerplate that provides no actual information about KPI definition. Phrases like 'provides automated assistance' and 'follows industry best practices' are meaningless filler that Claude doesn't need. | 1 / 3 |
Actionability | No concrete guidance, code, examples, or specific instructions are provided. The skill describes what it claims to do but never actually teaches how to define KPIs, what makes a good KPI, or any actionable methodology. | 1 / 3 |
Workflow Clarity | No workflow is defined. The skill mentions 'step-by-step guidance' but provides none. There are no steps, no sequence, and no validation checkpoints for KPI definition processes. | 1 / 3 |
Progressive Disclosure | The content is a flat, uninformative structure with no references to detailed materials, no examples, and no links to related documentation. It's essentially an empty shell with section headers. | 1 / 3 |
Total | 4 / 12 Passed |
Validation
69%Validation — 11 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
description_trigger_hint | Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...') | Warning |
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 11 / 16 Passed | |
- 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.