Can I use this for security compliance?

While it is not a full security suite, it includes critical security principles such as input validation, secret management, and protecting PII in logs.

How does it improve function design?

It enforces the Single Responsibility Principle, provides guidelines for limiting parameters to 0-2, and encourages keeping functions under 50 lines for better testability.

Is this skill specific to a particular programming language?

No, these principles are intentionally language-agnostic and can be applied to any programming paradigm, including Object-Oriented, Functional, or Procedural code.

How does this skill help with technical debt?

It provides specific triggers for incremental refactoring and encourages a 'refactor-as-you-go' approach to ensure code quality improves continuously.

Does this skill help with code documentation?

Yes, it provides clear standards on when to comment (explaining 'why' rather than 'how') and emphasizes writing self-documenting code and public API interfaces.

Coding Principles for Maintainability

Name: Coding Principles for Maintainability
Author: Tahir-yamin

byTahir-yamin

•

Developer Tools

Enforces high-quality, language-agnostic standards for readable, maintainable, and secure software development.

This skill provides a comprehensive framework for writing clean, sustainable code regardless of the programming language or stack. It guides developers through core philosophies like simplicity and explicit intentions, offering practical patterns for function design, error management, and dependency injection. By integrating these principles into the development workflow, the skill helps teams reduce technical debt, improve code review quality, and build resilient architectures that prioritize long-term maintainability over short-term speed.

Key Features

01Offers structured refactoring triggers to address code smells and technical debt

02Guides dependency management through loose coupling and injection patterns

03Provides language-agnostic guidelines for function design and parameter management

04Enforces robust error handling and secure logging practices to protect sensitive data

053 GitHub stars

06Standardizes code organization and file structure for better project navigation

Use Cases

01Conducting automated code reviews to ensure consistency and maintainability across team projects

02Establishing a standardized engineering playbook for onboarding and architectural consistency

03Refactoring legacy modules to reduce cyclomatic complexity and improve readability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tahir-yamin/dev-engineering-playbook coding-principles

For use in Claude.ai and ChatGPT

Download Skill