skills.rest
Helcio-Nogueira
Helcio-NogueiraCOMMUNITY
Explore all skills by this author →
GitHub

clean-code

Enforces concise coding standards, naming rules, and verification workflows for AI-written code.

Updated Mar 23, 2026
Search Tags:#code quality#refactoring#clean code#coding standards#verification#naming conventions#lint
One-click install
npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill clean-code-helcio-nogueira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clean-code
Source: https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026/tree/main/.agents/skills/clean-code
Command: npx skills add https://github.com/Helcio-Nogueira/Painel_Inteligente_Hackaton_2026 --skill clean-code-helcio-nogueira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated code often suffers from over-engineering, excessive comments, deep nesting, and broken cross-file dependencies. This Skill enforces pragmatic coding standards so every code change stays concise, direct, and consistent. ## Core Features & Use Cases - Coding Standards Enforcement: Applies SRP, DRY, KISS, and YAGNI principles with concrete naming, function size, and structure rules. - Dependency-Aware Editing: Requires checking imports and dependents before modifying any file, preventing broken references. - Verification Script Routing: Maps each specialist agent to its correct validation script (lint, type coverage, UX audit, security scan) with a mandatory read-summarize-ask output workflow. - Use Case: When an AI agent refactors a TypeScript service, the Skill forces it to check all importing files, keep functions under 20 lines, run the lint script, and summarize results before claiming completion. ## Quick Start Ask the AI to write or refactor any code and it will automatically apply clean code standards, check dependent files, and run the appropriate verification script.

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 in AI-generated code?▼

Apply explicit rules for naming, function size, and structure that the AI must follow on every edit. This Skill encodes SRP, DRY, KISS, and YAGNI principles plus a mandatory self-check before any task is marked complete.

What coding principles does this Skill enforce?▼

It enforces Single Responsibility, DRY, KISS, YAGNI, and the Boy Scout rule. Functions are limited to 20 lines with at most 3 arguments, nesting is capped at 2 levels, and obvious comments are prohibited.

How does the Skill prevent broken imports when editing files?▼

Before editing any file, the AI must identify what imports the file and what the file imports. All dependent files must be updated in the same task, so no broken imports or stale references are left behind.

Which verification scripts run after code changes?▼

Each agent runs only its own script, such as lint_runner.py and type_coverage.py for any agent, ux_audit.py for frontend work, or security_scan.py for security audits. Output must be read, summarized, and confirmed with the user before fixes.

When should clean code rules not block a quick fix?▼

The Skill is pragmatic: small one-liners should be inlined rather than wrapped in helpers, and bug fixes should be applied directly without lengthy explanations. Standards never justify over-engineering simple solutions.

Related Skills

Explore More Software Engineering Skills→
scute-shscute-sh
3

scout-codebase

Assess code clarity, test coverage, and technical debt before modification.

Official
Intermediate
DataDogDataDog
648

lint

Run Hatch-based lint, format, and quality checks on modified files.

Official
Advanced
mazelbmazelb
1

code-quality

Review code quality, dependencies, and performance across Python, TypeScript, and Kotlin projects.

Community
Advanced
trystan2ktrystan2k

biome

Configure Biome as a unified linter and formatter for JavaScript/TypeScript projects.

Community
Advanced