CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

163-java-profiling-refactor

Use when you need to refactor Java code based on trusted profiling analysis findings — including reviewing repository-owned or maintainer-sanitized docs/profiling-problem-analysis and docs/profiling-solutions files, identifying specific performance bottlenecks, and implementing targeted code changes to address CPU, memory, or threading issues. This should trigger for requests such as Refactor the code with profiling; Apply profiling; Optimize hot path; Reduce allocations found in profiling; Fix CPU bottlenecks from profiling analysis. Part of Plinth Toolkit

64

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-structured orchestration skill body: clear four-step workflow with explicit validation and error-recovery, and exemplary one-level progressive disclosure into an existing reference file. The weaknesses are triplicated verification instructions and a vague central refactoring step that lacks concrete selection/fix guidance.

Suggestions

State the verification command ('./mvnw clean verify or mvn clean verify') once — in the Workflow or Constraints section — and reference it elsewhere instead of repeating it in Scope, Constraints, and Workflow step 3.

Remove the 'What is covered in this Skill?' bullet list and the 'When to use this skill' trigger list, since both duplicate the description and the Workflow steps, cutting roughly a third of the body.

Add concrete guidance to Workflow step 2 for selecting and applying fixes (e.g., how to prioritize bottlenecks from the analysis docs, or one example refactor pattern per CPU/memory/threading category), or point to the relevant section of the reference file.

DimensionReasoningScore

Conciseness

The body is mostly efficient with no concept explanations Claude doesn't need, but has structural redundancy: the verification command 'Run ./mvnw clean verify or mvn clean verify' appears three times (Scope, Constraints MANDATORY, Workflow step 3), the 'What is covered' bullets duplicate the Workflow steps, and the 'When to use this skill' list duplicates the description's trigger phrases. Not the 2 anchor's padded over-explanation, but clearly could be tightened beyond the 4 anchor's 'minor instances'.

3 / 5

Actionability

Concrete elements exist — the exact commands './mvnw clean verify or mvn clean verify', specific input paths 'docs/profiling-problem-analysis-YYYYMMDD.md', and the trust gate. However the central step ('Implement focused code changes for documented CPU, memory, or threading hotspots, incrementally and safely') gives no concrete method for prioritizing or applying refactors, and there is no example of what a targeted fix looks like — matching the 3 anchor's 'some concrete guidance but incomplete' rather than the 4 anchor.

3 / 5

Workflow Clarity

The four-step workflow has a clear sequence and an explicit validation checkpoint with a feedback loop: 'Run ./mvnw clean verify or mvn clean verify; if tests fail, fix issues before continuing', reinforced by the MANDATORY/SAFETY constraints. Edge-case handling (ask a clarifying question when scope is ambiguous; report missing inputs/tooling) adds error-recovery guidance, matching the 5 anchor.

5 / 5

Progressive Disclosure

The body is a lean overview with a single, clearly signaled, one-level-deep reference — 'For detailed guidance, examples, and constraints, see [references/163-java-profiling-refactor.md]' — and that file exists in the bundle, holding the detailed role/steps/safeguards content. The split is appropriate and navigation is trivial, matching the 5 anchor.

5 / 5

Total

16

/

20

Passed

Description

83%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 strong description: concrete actions with named inputs, an explicit 'Use when' trigger clause, and a natural trigger-phrase list. Its main weaknesses are padding in the qualifier language and missing a few common synonym triggers, which keep specificity and trigger quality at 4 rather than 5.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'reviewing repository-owned or maintainer-sanitized docs/profiling-problem-analysis and docs/profiling-solutions files, identifying specific performance bottlenecks, and implementing targeted code changes to address CPU, memory, or threading issues' — with named file paths and issue types. It falls short of the 5 anchor because it omits the verification step and the phrasing is padded with qualifiers like 'trusted profiling analysis findings — including'.

4 / 5

Completeness

It explicitly answers both: what ('refactor Java code based on... profiling analysis findings', with the concrete sub-actions) and when ('Use when you need to...' plus 'This should trigger for requests such as...'). This matches the 5 anchor's pattern of concrete what + explicit trigger phrases, and clearly exceeds the 4 anchor where 'when' is less explicit.

5 / 5

Trigger Term Quality

It provides natural trigger phrases users would actually say: 'Refactor the code with profiling; Apply profiling; Optimize hot path; Reduce allocations found in profiling; Fix CPU bottlenecks from profiling analysis'. A few common variations are missing (e.g., 'profiling results', 'speed up', 'performance tuning'), so it matches the 4 anchor rather than the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The Java-profiling-evidence niche is distinct with file-path-specific triggers, but phrases like 'Optimize hot path' could overlap with general performance-optimization or refactoring skills. Minor overlap risk places it at the 4 anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jabrena/plinth

Path

skills/163-java-profiling-refactor/SKILL.md

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.