Use when you need to refactor Java code based on profiling analysis findings — including reviewing docs/profiling-problem-analysis and docs/profiling-solutions, identifying specific performance bottlenecks, and implementing targeted code changes to address CPU, memory, or threading issues. Part of the skills-for-java project
83
78%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/163-java-profiling-refactor/SKILL.mdQuality
Discovery
100%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 strong skill description that clearly communicates its purpose, triggers, and scope. It opens with an explicit 'Use when' clause, lists concrete actions (reviewing profiling docs, identifying bottlenecks, implementing changes), and specifies the domain narrowly (Java profiling-based refactoring for CPU, memory, threading). The only minor note is the trailing 'Part of the skills-for-java project' which adds context but isn't critical for skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: reviewing profiling analysis docs, identifying performance bottlenecks, and implementing targeted code changes. Also specifies the types of issues addressed: CPU, memory, or threading issues. | 3 / 3 |
Completeness | Clearly answers both what (reviewing profiling docs, identifying bottlenecks, implementing code changes for CPU/memory/threading) and when ('Use when you need to refactor Java code based on profiling analysis findings') with an explicit 'Use when' clause at the start. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'refactor', 'Java code', 'profiling', 'performance bottlenecks', 'CPU', 'memory', 'threading issues'. Also references specific doc paths which aids in matching. These are terms a developer would naturally use when discussing performance optimization. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — it's specifically about Java performance refactoring based on profiling analysis, referencing specific documentation paths. This is a clear niche that wouldn't easily conflict with general Java coding skills or generic refactoring skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides a reasonable overview of the profiling refactoring workflow with good progressive disclosure to a reference file. However, it lacks concrete executable examples of common refactoring patterns inline, has some redundancy in its bullet points, and the workflow would benefit from explicit numbered steps with validation checkpoints rather than scattered constraints.
Suggestions
Add a numbered workflow sequence (1. Read docs → 2. Identify bottlenecks → 3. Apply fix → 4. Run ./mvnw clean verify → 5. If tests fail, fix and re-verify → 6. Repeat for next bottleneck) to improve workflow clarity with an explicit feedback loop.
Include at least one concrete before/after code example of a common refactoring pattern (e.g., replacing a hot-path String concatenation with StringBuilder) to improve actionability.
Remove the duplicate 'Refactor the code with profiling' bullet in the 'When to use this skill' section and eliminate redundancy between the opening paragraph and the 'What is covered' section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient but has some redundancy — the 'What is covered' section largely repeats the opening paragraph, and the 'When to use this skill' section has a duplicate bullet ('Refactor the code with profiling' appears twice). Some tightening possible. | 2 / 3 |
Actionability | Provides concrete commands (./mvnw clean verify) and references specific file patterns, but lacks executable code examples for actual refactoring patterns. The real actionable content is deferred to the reference file rather than shown inline. | 2 / 3 |
Workflow Clarity | Steps are implied (read docs → identify bottlenecks → refactor → verify) but not explicitly sequenced with numbered steps and validation checkpoints. The constraint about running tests is mentioned but there's no explicit feedback loop (validate → fix → re-validate) structured as a clear workflow. | 2 / 3 |
Progressive Disclosure | Clean structure with a concise overview and a single well-signaled reference to the detailed guidance file. One level deep, clearly navigable, and appropriately split between overview and detailed content. | 3 / 3 |
Total | 9 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
9ec21dd
Table of Contents
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.