skills.rest
paulojalowyj
paulojalowyjCOMMUNITY
Explore all skills by this author →
Website𝕏@paulojalowyjGitHub

clean-code

Enforce pragmatic coding standards for maintainable software development.

6|Updated Feb 6, 2026
Search Tags:#refactoring#clean code#coding standards#maintainability#developer productivity#ai coding
One-click install
npx skills add https://github.com/paulojalowyj/openkit --skill clean-code-paulojalowyj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/paulojalowyj/openkit/tree/main/.opencode/skills/clean-code
Command: npx skills add https://github.com/paulojalowyj/openkit --skill clean-code-paulojalowyj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enforces pragmatic coding standards to ensure code is concise, direct, and avoids over-engineering, leading to more maintainable and understandable software.

Core Features & Use Cases

  • Enforces SOLID principles: Promotes Single Responsibility, Don't Repeat Yourself, Keep It Simple, You Ain't Gonna Need It, and the Boy Scout Rule.
  • Standardizes Naming Conventions: Ensures variables, functions, and constants are named clearly and reveal intent.
  • Optimizes Function Design: Guides developers to write small, focused functions with minimal arguments and no side effects.
  • Promotes Clean Code Structure: Encourages guard clauses, flat code, composition, and colocation.
  • AI Coding Style Guidelines: Directs AI agents on how to respond to user requests, fix bugs, and handle unclear requirements.
  • Pre-edit File Checks: Mandates thinking about dependencies and impact before modifying any file.
  • Self-Checklists: Provides mandatory verification steps before task completion.
  • Script Verification: Defines specific scripts for agents to run for validation and outlines strict output handling procedures.

Quick Start

Use the clean-code skill to refactor the provided function to adhere to the Single Responsibility Principle.

Frequently Asked Questions about clean-code

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

FAQPage Schema
How do I enforce clean code standards and SOLID principles during refactoring?▼

Clean code standards are enforced by applying SRP, DRY, KISS, YAGNI, and the Boy Scout Rule to ensure concise, direct, and maintainable software development. This skill mandates clear naming conventions, small focused functions, and flat code structure for all modifications.

What are the best practices for writing maintainable code with minimal side effects?▼

Maintainable code requires small, focused functions with minimal arguments and no side effects. You achieve this by standardizing naming conventions to reveal intent, promoting flat code structures, using guard clauses, and following the Boy Scout Rule during modifications.

How do I set coding standards for AI agents to fix bugs and handle unclear requirements?▼

Coding standards for AI agents are set using AI-specific interaction guidelines that direct how agents respond to requests, fix bugs, and handle unclear requirements. The skill mandates pre-edit file checks to analyze dependencies and self-checklists for verification before task completion.

Do I need Python to run clean code validation scripts?▼

Python is required as a dependency to run the defined validation scripts. The skill uses these scripts to verify code compliance, outline strict output handling procedures, and enforce mandatory self-checklists before completing any coding task.

When should I apply the Single Responsibility Principle to avoid over-engineering?▼

Apply the Single Responsibility Principle during all code modifications, bug fixes, and feature implementations to avoid over-engineering. The skill enforces pragmatic coding standards by requiring pre-edit dependency checks and composition over complex structures.

Related Skills

Explore More Software Engineering Skills→
AubreyHanAubreyHan

managing-python-dependencies

Detect Python dependency managers and run matching install commands.

Community
Intermediate
PostalocityPostalocity
1

framework-compliance-audit

Automate framework compliance audits and generate validation reports.

Official
Advanced
thec3ukthec3uk

Global Coding Style

Enforce global coding style standards across files and languages.

Official
Basic
jmaglyjmagly
175

eslint-checker

Execute ESLint to enforce code quality and style for JavaScript and TypeScript projects.

Community
Intermediate