Audit Java, C#, and JavaScript code against the five SOLID principles with evidence-ranked findings and patches.
npx skills add https://github.com/david181222/Paragon --skill solid-david181222
Please help me install this Agent Skill. Skill: solid Source: https://github.com/david181222/Paragon/tree/main/.claude/skills/solid Command: npx skills add https://github.com/david181222/Paragon --skill solid-david181222
new member hiding, and accidental Java overloads. - Four triage modes with output caps: SPOT (one design question), HIERARCHY (one class tree), DIFF (pull request review including untouched supertypes), and REPO (full audit with measured debt metrics and a self-verification pass). - Prescription catalog with migration sequencing: Maps each violation to a concrete refactor (role interfaces, delegation, composition vs. aggregation, strategy, decorator) ordered so every step compiles and is independently revertible. - Use Case: A reviewer asks whether a ReadOnlyStorage : FileStorage hierarchy is safe. The Skill detects the new-hidden no-op Save method, rates it CRITICAL with the 7 affected call sites, prescribes an ISP split into readable/writable role interfaces, and generates an xUnit substitution test proving the defect. ## Quick Start Ask the assistant to audit a class hierarchy, file, pull request, or repository for SOLID violations, for example by requesting a SOLID review of your pricing module's inheritance structure.High-intent search queries and answers about installing and using this skill.
Point the audit at a file, hierarchy, pull request, or repository and it runs a phased protocol: reconnaissance, an automated smell scan, per-principle analysis, and contract inference. Every finding includes file:line evidence, a concrete failure mode, blast radius, and a patch.
The highest-yield check is searching for async overrides of synchronous base methods, which silently return Promises where callers expect values. The audit also checks arity mismatches, shape narrowing on parameters, and derives the substitution surface from call sites since JavaScript declares no interfaces.
Yes, scope is deliberately limited to Java, C#, and JavaScript because each language's compiler enforces different parts of the contract. It catches C# `new` member hiding and static `==` resolution, Java accidental overloads from missing `@Override`, and JavaScript prototype and frozen-object issues.
Use composition when a subtype reuses base code but is not base behavior, adds value-carrying fields to an equality-bearing base, or changes the mutability contract. The refactorings reference includes a decision tree and a composition-versus-aggregation table to pick the correct relation.
An evidence guardrail applies: without a test suite for the base types, all contract items are marked inferred with low confidence, and structural refactors are not prescribed. The audit recommends characterization tests first to pin down current behavior before any redesign.
Yes, DIFF mode audits only the changed surface plus the supertypes and subtypes of changed types, since editing a base class alone can introduce LSP violations. Output is capped at one page covering only findings introduced by that diff.
ayo-oooIdentify project structure, dependencies, and entry points from common manifests.
kiprotichgidiiAnalyze codebases to identify, quantify, and prioritize technical debt with remediation plans.
OpenWaggleDetect dead code, duplicates, and structural weaknesses in JavaScript and TypeScript codebases.
ctimmerman-progAutomate ArchUnit architectural constraint checks in Java projects.