CtrlK
BlogDocsLog inGet started
Tessl Logo

analyzing-system-throughput

Analyze and optimize system throughput including request handling, data processing, and resource utilization. Use when identifying capacity limits or evaluating scaling strategies. Trigger with phrases like "analyze throughput", "optimize capacity", or "identify bottlenecks".

40

Quality

41%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/performance/throughput-analyzer/skills/analyzing-system-throughput/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

0%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is almost entirely descriptive filler with no actionable content. It repeatedly explains what throughput analysis is and when to use it, but never provides concrete commands, code, metrics to examine, or specific analytical techniques. The references to a 'throughput-analyzer' plugin and metrics directory are undefined, making the skill non-functional.

Suggestions

Replace the abstract workflow with concrete, executable steps showing specific commands or code for collecting and analyzing throughput metrics (e.g., actual CLI commands, script invocations, or code snippets).

Remove the 'Overview', 'How It Works', 'When to Use', 'Best Practices', 'Integration', and 'Resources' sections entirely — they add no actionable value and waste tokens on concepts Claude already understands.

Define the 'throughput-analyzer' plugin concretely: show its invocation syntax, expected inputs, and output format, or remove references to it if it doesn't exist.

Add validation checkpoints to the workflow (e.g., 'Verify metrics are being collected by checking X', 'Confirm baseline data exists before proceeding') and include concrete examples with sample input data and expected output.

DimensionReasoningScore

Conciseness

Extremely verbose with extensive explanation of concepts Claude already knows. The 'Overview', 'How It Works', 'When to Use', 'Best Practices', 'Integration', and 'Resources' sections are almost entirely filler that restates obvious information. The skill explains what throughput analysis is rather than providing actionable instructions.

1 / 3

Actionability

No concrete code, commands, or executable guidance anywhere. The 'Instructions' section is a vague 6-step list with no specifics on how to actually perform any step. The examples describe what 'the skill will do' in abstract terms rather than showing concrete analysis techniques, commands, or code snippets. References a 'throughput-analyzer' plugin with no details on how to invoke it.

1 / 3

Workflow Clarity

The workflow steps are abstract and lack any validation checkpoints. Steps like 'Identify critical system components' and 'Collect request and data throughput metrics' provide no concrete guidance on how to accomplish them. No feedback loops, no validation steps, and no error recovery within the workflow itself.

1 / 3

Progressive Disclosure

Monolithic wall of text with no bundle files to reference. Multiple sections repeat similar content (How It Works, Instructions, Examples all cover the same ground). No external references are provided despite mentioning paths like '${CLAUDE_SKILL_DIR}/metrics/throughput/' and a 'throughput-analyzer' plugin that are never defined or linked.

1 / 3

Total

4

/

12

Passed

Description

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a reasonably well-constructed description that clearly communicates both purpose and trigger conditions. Its main weakness is that the capability descriptions remain at a somewhat abstract level (e.g., 'data processing', 'resource utilization') rather than listing truly concrete actions. The explicit trigger phrases are a strong point, though the broad domain could cause overlap with adjacent performance-related skills.

Suggestions

Replace broad terms like 'data processing' and 'resource utilization' with more concrete actions such as 'measure requests per second', 'profile queue latency', or 'generate capacity planning reports' to improve specificity.

Add distinguishing details about what kind of systems this applies to (e.g., web services, databases, message queues) to reduce potential overlap with other performance or infrastructure skills.

DimensionReasoningScore

Specificity

Names the domain (system throughput) and lists some actions (analyze, optimize, request handling, data processing, resource utilization), but these are still fairly broad categories rather than multiple concrete, specific actions like 'measure requests per second', 'profile queue depths', or 'generate load test reports'.

2 / 3

Completeness

Clearly answers both 'what' (analyze and optimize system throughput including request handling, data processing, and resource utilization) and 'when' (identifying capacity limits, evaluating scaling strategies) with explicit trigger phrases provided.

3 / 3

Trigger Term Quality

Includes natural trigger phrases users would say: 'analyze throughput', 'optimize capacity', 'identify bottlenecks', plus related terms like 'scaling strategies', 'capacity limits', 'request handling', and 'resource utilization'. Good coverage of terms a user would naturally use.

3 / 3

Distinctiveness Conflict Risk

While 'throughput' and 'bottlenecks' are somewhat distinctive, terms like 'optimize', 'resource utilization', and 'scaling strategies' could overlap with general performance optimization, infrastructure management, or cloud scaling skills. The scope is broad enough to potentially conflict with more specialized skills.

2 / 3

Total

10

/

12

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

9

/

11

Passed

Repository
jeremylongshore/claude-code-plugins-plus-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.