clean-code

Detect clean-code violations and recommend fixes in the NewsParser codebase.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/roromanenko/NewsParser --skill clean-code-roromanenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/roromanenko/NewsParser/tree/main/.claude/skills/clean-code
Command: npx skills add https://github.com/roromanenko/NewsParser --skill clean-code-roromanenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill helps identify and fix code-quality issues in the NewsParser codebase by highlighting concrete clean-code violations and providing real-world examples from the project.

Core Features & Use Cases

  • Detect long methods and suggest extraction of private helpers.
  • Enforce naming clarity, appropriate parameter counts, and comment guidelines.
  • Promote guard clauses to reduce nesting and improve readability.
  • Replace magic numbers with named constants and centralized options.
  • Identify and remove dead or misleading code and comments with rationale.

Quick Start

Review the NewsParser codebase to identify and apply clean-code rules to target files such as ArticleAnalysisWorker.cs and SourceFetcherWorker.cs.

Frequently Asked Questions about clean-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify clean-code violations during a code review?

To identify clean-code violations during a code review, analyze method length, naming clarity, parameter counts, comment quality, and dead code. This process detects long methods, magic numbers, and nested logic, recommending guard clauses and extracted private helpers to improve readability.

How do I refactor long methods and reduce nesting in C# worker files?

Refactor long methods in C# worker files by extracting private helpers and promoting guard clauses to reduce nesting. Replace misleading comments and dead code with centralized options and named constants to enforce clean-code standards across files like ArticleAnalysisWorker.cs.

What is the best way to eliminate dead code and code smells in a repository?

The best way to eliminate dead code and code smells in a repository is to apply explicit clean-code rules that identify and remove misleading code and comments with rationale. This enforces naming clarity and replaces magic numbers with named constants during refactoring.

Can I use these clean-code rules for refactoring the NewsParser codebase specifically?

Yes, you can use these clean-code rules for refactoring the NewsParser codebase specifically. The rules apply directly to target files such as SourceFetcherWorker.cs, guiding automated checks and manual reviews for method length, argument counts, and naming clarity.

Why should I replace magic numbers with named constants when fixing code smells?

You should replace magic numbers with named constants when fixing code smells to improve naming clarity and centralize configuration options. This clean-code practice eliminates ambiguous values, making the codebase easier to read, maintain, and review.