jordangunn/refactor-structural-duplication
skills/refactor/structural-duplication/SKILL.md
Identify structurally duplicate logic (pipeline-spine duplication) across semantically distinct modules. Use when multiple implementations share the same orchestration skeleton (e.g., bounds→shape→chunking→reduction→wrap), and unification may require subtle abstraction. Produces a duplication map and a safe extraction/refactor plan.
$ install --global
skillsauthnpx skillsauth add jordangunn/skills refactor-structural-duplicationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 10:26 AM210.8s6 files scanned
SKILL.md
- name:
- refactor-structural-duplication
- license:
- MIT
- description:
- >
- author:
- Jordan Godau
Instructions
Read all references in references/ before starting.
Goal
Detect and report structural duplication across modules (not copy/paste), especially where:
- different domain concepts remain correctly separate, but
- the underlying processing pipeline is parallel/duplicated, risking drift.
When unification likely requires subtle abstraction, produce a staged plan that can be executed safely.
Scope
- This skill does not enforce “thin public facades” or restructure public APIs.
- This skill does identify shared pipeline spines and propose extraction targets and abstraction seams.
Signals
Activate when any of the following are true:
- Multiple modules implement similar orchestration stages (even with different operators).
- There are parallel implementations of structurally similar functionality in the codebase.
- The agent (or a developer) is about to re-implement “the same infrastructure again” for a new product.
Procedure
Follow references/03_PROCEDURE.md.
Output
Produce a single Markdown report using references/05_OUTPUT_TEMPLATE.md.
If abstraction is needed, include a staged plan using references/04_REFACTOR_PLAN_TEMPLATE.md.
Related Skills
jordangunn/task-validate
testing
VerifiedTrustedCommunity
Validate a task by setting epistemic_state to validated. Requires explicit validation info (who/why). Computes hash and updates last_reviewed_at.
6SKILL.mdUpdated Apr 6, 2026
jordangunn/task-status
tools
VerifiedTrustedCommunity
Compute and display derived status for a task. Runs deterministic status computation and outputs summary of staleness, hash integrity, and eligibility.
6SKILL.mdUpdated Apr 6, 2026
jordangunn/task-review
tools
VerifiedTrustedCommunity
Review a task by updating last_reviewed_at timestamp. Recomputes derived status and flags any hash mismatches without changing epistemic state.
6SKILL.mdUpdated Apr 6, 2026
jordangunn/task-prev
testing
VerifiedTrustedCommunity
Navigate to the previous task in chronological order. Returns the task ID before the specified task based on created_at timestamp.
6SKILL.mdUpdated Apr 6, 2026