coding-best-practices

Codifies coding best practices for clean, maintainable code across reviews and refactoring.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/heykvnzhao/dotfiles --skill coding-best-practices-heykvnzhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coding-best-practices
Source: https://github.com/heykvnzhao/dotfiles/tree/main/skills/coding-best-practices
Command: npx skills add https://github.com/heykvnzhao/dotfiles --skill coding-best-practices-heykvnzhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

General coding principles and guidelines to help teams write clean, maintainable code and make better decisions about structure, reviews, refactoring, dependency changes, and design discussions.

Core Features & Use Cases

  • Codifies core principles (Fix root causes, Simplicity, Quality Bar, Clean Up Ruthlessly, No Breadcrumbs, Scope Control) to guide development.
  • Provides code-organization and architecture guidelines (File Length, UI Component Files, Separation Principles, Directory Structure) to improve readability and maintainability.
  • Useful during development work, code reviews, refactors, and design discussions to align on standards and best practices.

Quick Start

Audit a module and implement a small, well-scoped improvement following these principles.

Frequently Asked Questions about coding-best-practices

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

FAQPage Schema
What are the best practices for writing clean and maintainable code?

Clean and maintainable code relies on core principles like fixing root causes, enforcing a quality bar, and maintaining strict scope control. Applying simplicity and ruthless cleanup during development prevents technical debt and ensures long-term readability.

How do I structure code architecture guidelines for better readability?

Code architecture guidelines improve readability by enforcing file length limits, separating UI component files, and organizing directory structures logically. Separation principles ensure modules remain decoupled, making the system easier to navigate and maintain.

What should I look for during a code review to ensure quality?

During a code review, focus on identifying root causes rather than surface fixes, verifying scope control, and ensuring no breadcrumbs are left behind. Aligning on these standards prevents technical debt and maintains a consistent quality bar.

How do I refactor existing modules to improve maintainability?

Refactor existing modules by auditing the codebase and implementing small, well-scoped improvements that follow clean coding principles. Apply separation principles and clean up ruthlessly to incrementally increase maintainability without breaking existing functionality.

Can I use these coding principles to guide dependency changes and design discussions?

Yes, these coding principles actively guide teams during dependency changes and design discussions. By codifying standards around simplicity and quality bars, teams can make better structural decisions and align on maintainability metrics before implementation.