coding

Enforce maintainable design practices across coding, reviews, and refactoring.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/agoetc/home-manager --skill coding-agoetc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: coding
Source: https://github.com/agoetc/home-manager/tree/main/programs/claude/skills/coding
Command: npx skills add https://github.com/agoetc/home-manager --skill coding-agoetc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides design principles and best practices to help developers write correct, maintainable code across coding tasks, reviews, and refactoring.

Core Features & Use Cases

  • Prioritize pure functions and separate side effects to keep business logic clean.
  • Use immutable data and type-level constraints to express valid states and prevent bugs.
  • Apply dependency injection and boundary-layer design to improve testability and modularity.
  • Favor early returns and block scoping to improve readability and reduce nesting.
  • Adhere to core design principles: YAGNI, DRY (with pragmatic restraint), and single responsibility.
  • Avoid common anti-patterns such as swallowing exceptions and mutable globals to improve reliability.

Quick Start

Apply these principles in your next coding task to ensure correct, maintainable code from day one.

Frequently Asked Questions about coding

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

FAQPage Schema
How do I write maintainable code that separates business logic from side effects?

To write maintainable code, prioritize pure functions and isolate side effects to keep core business logic clean. This separation ensures your functional design remains testable and predictable across daily coding tasks.

What is the best way to prevent bugs using immutability and type constraints?

Using immutable data and type-level constraints prevents bugs by explicitly expressing valid states. This design practice makes invalid states unrepresentable, ensuring correct and reliable code behavior during refactoring.

How do I improve code readability and reduce deep nesting in function design?

Improve code readability by favoring early returns and block scoping to reduce nesting. Applying these clean code practices alongside the single responsibility principle keeps functions focused and easy to review.

Does dependency injection help with testability and modular code reviews?

Dependency injection improves testability and modularity by applying boundary-layer design. This approach allows you to isolate external dependencies during code reviews, ensuring your core logic remains clean and independently testable.

When should I avoid premature optimization in clean code refactoring?

Avoid premature optimization during refactoring by adhering to the YAGNI principle and applying DRY with pragmatic restraint. Focus on correct, maintainable design first rather than speculative performance gains.

Why does swallowing exceptions harm code reliability during refactoring?

Swallowing exceptions harms reliability by hiding failures and creating mutable global state issues. Avoiding these anti-patterns during refactoring ensures errors surface correctly, maintaining robust and dependable code quality.