code-clone-assistant

Detects and refactors code duplication using PMD CPD. Use when identifying code clones, addressing DRY violations, or refactoring duplicate code across repositories.

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026⬇️1downloads

When & Why to Use This Skill

The Code Clone Assistant is a specialized Claude skill designed to identify and eliminate code duplication by leveraging the combined power of PMD CPD and Semgrep. It helps developers maintain high code quality and adhere to the DRY (Don't Repeat Yourself) principle by detecting exact copy-pasted blocks as well as structural patterns with variations, providing a comprehensive solution for reducing technical debt and improving maintainability.

Use Cases

  • Legacy Codebase Refactoring: Identify and consolidate identical logic blocks that have been duplicated across large, aging repositories to simplify maintenance.
  • DRY Violation Detection: Find 'near-miss' clones where the logic is the same but variable names or formatting differ, ensuring consistent implementation.
  • Technical Debt Assessment: Audit codebases to quantify the extent of duplication, helping teams prioritize areas for architectural improvement.
  • Automated Logic Consolidation: Streamline the process of extracting shared utility functions by identifying repeated validation or boilerplate patterns across multiple files.
namecode-clone-assistant
descriptionDetects and refactors code duplication using PMD CPD. Use when identifying code clones, addressing DRY violations, or refactoring duplicate code across repositories.
allowed-toolsRead, Grep, Bash, Edit, Write

Code Clone Assistant

Detect code clones and guide refactoring using PMD CPD (exact duplicates) + Semgrep (patterns).

Tools

  • PMD CPD v7.17.0+: Exact duplicate detection
  • Semgrep v1.140.0+: Pattern-based detection

Tested: October 2025 - 30 violations detected across 3 sample files Coverage: ~3x more violations than using either tool alone


When to Use

Triggers: "find duplicate code", "DRY violations", "refactor similar code", "detect code duplication", "similar validation logic", "repeated patterns", "copy-paste code", "exact duplicates"


Why Two Tools?

PMD CPD and Semgrep detect different clone types:

Aspect PMD CPD Semgrep
Detects Exact copy-paste duplicates Similar patterns with variations
Scope Across files ✅ Within/across files (Pro only)
Matching Token-based (ignores formatting) Pattern-based (AST matching)
Rules ❌ No custom rules ✅ Custom rules

Result: Using both finds ~3x more DRY violations.

Clone Types

Type Description PMD CPD Semgrep
Type-1 Exact copies ✅ Default ✅
Type-2 Renamed identifiers ✅ --ignore-* ✅
Type-3 Near-miss with variations ⚠️ Partial ✅ Patterns
Type-4 Semantic clones (same behavior) ❌ ❌

Quick Start Workflow

# Step 1: Detect exact duplicates (PMD CPD)
pmd cpd -d . -l python --minimum-tokens 20 -f markdown > pmd-results.md

# Step 2: Detect pattern violations (Semgrep)
semgrep --config=clone-rules.yaml --sarif --quiet > semgrep-results.sarif

# Step 3: Analyze combined results (Claude Code)
# Parse both outputs, prioritize by severity

# Step 4: Refactor (Claude Code with user approval)
# Extract shared functions, consolidate patterns, verify tests


Reference Documentation

For detailed information, see: