# Review Code for Clean Code Issues

Code quality issues slow reviews and make changes risky. This skill finds Clean Code problems and gives prioritized refactoring guidance.

## Install

```bash
npx skillstore add hylarucoder/clean-code-reviewer
```

## Metadata

- Status: approved
- Slug: hylarucoder-clean-code-reviewer
- Skillstore revision: r1
- Version status: missing
- Tree hash: 9a76fe83d2256e740055399356d175be150067a11441f71115abd2619f89fe91
- Author: hylarucoder
- GitHub username: hylarucoder
- License: MIT
- Repository: https://github.com/hylarucoder/skills-for-vibe-coder/tree/main/skills/clean-code-reviewer
- Ref: a06681402992ceae98ba04d54cfd4ab004862696
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/hylarucoder-clean-code-reviewer
- Manifest: https://skillstore.pages.dev/api/skills/hylarucoder-clean-code-reviewer/manifest

## Capabilities

- Reviews code against seven Clean Code dimensions listed in the skill instructions.
- Flags vague names, inconsistent naming, oversized functions, and too many parameters.
- Identifies duplicate logic, dead code, over-engineering, magic numbers, and deep nesting.
- Applies language-specific review patterns for TypeScript, JavaScript, Python, and Go.
- Ranks findings by high, medium, or low severity with refactoring suggestions.
- Formats review output with principle, location, severity, problem, and recommendation.

## Use Cases

- Review Pull Requests: Find maintainability issues before merging code into a shared branch.
- Plan Refactoring Work: Prioritize high-impact cleanup tasks in legacy modules or active features.
- Standardize Team Practices: Apply consistent naming, function, and structure checks across a codebase.

## Prompt Templates

### Quick File Review

```
Review this file for Clean Code issues. List the highest impact naming, function, duplication, and magic number problems.
```

### Focused Refactoring Check

```
Review this module for oversized functions, too many parameters, and unclear responsibilities. Suggest behavior-preserving refactors.
```

### Language Pattern Review

```
Review this code using the language-specific patterns for TypeScript, JavaScript, Python, or Go. Group issues by severity.
```

### Repository Quality Audit

```
Audit the selected repository area for Clean Code issues. Deduplicate findings and produce a prioritized refactoring plan.
```

## Limitations

- Provides review guidance only and does not automatically modify code.
- Does not execute tests or prove that behavior remains unchanged.
- Does not focus on security, performance, or dependency risk analysis.
- Works best when the user provides relevant files and project conventions.

## Best Practices

- Provide the target files, review scope, language, and project conventions.
- Address high-severity findings before medium and low-severity cleanup.
- Verify behavior with tests after applying any refactoring suggestion.

## Anti Patterns

- Treating every suggestion as mandatory without considering project context.
- Mixing behavior changes with readability refactors in the same change.
- Running broad audits without specifying the target module or language.

## Security Audit

- Audited at: 2026-07-06T14:21:39.902\+00:00
- Summary: The static command, network, reconnaissance, and obfuscation hits are false positives from markdown formatting and educational code examples. No evidence found for executable scripts, active network requests, system reconnaissance, or data exfiltration in the skill instructions. However, evaluation-output.json embeds a prior safe-to-publish audit verdict, which is a high-severity prompt-injection risk for marketplace review.

## Stats

- Views: 207
- Downloads: 27
- Favorites: 0
- Popularity score: 0