skills.rest
mkokutoyori
mkokutoyoriCOMMUNITY
Explore all skills by this author →
GitHub

software-craftsman

Enforce SOLID, DRY, KISS, and test-driven development in software projects.

Updated Dec 11, 2025
Search Tags:#tdd#extensibility#software-engineering#design-patterns#clean-architecture#solid-principles#coding-best-practices
One-click install
npx skills add https://github.com/mkokutoyori/ubuntu-sandbox --skill software-craftsman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: software-craftsman
Source: https://github.com/mkokutoyori/ubuntu-sandbox/tree/main/.claude/skills/software-craftsman
Command: npx skills add https://github.com/mkokutoyori/ubuntu-sandbox --skill software-craftsman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Senior software engineers often struggle to produce code that is easy to maintain, test, and extend over time. This skill provides a blueprint for writing production-grade software that adheres to SOLID, DRY, KISS, and clean architecture while anticipating future needs.

Core Features & Use Cases

  • Enforces SOLID, DRY, KISS, and established design patterns to keep code robust and extensible.
  • Guides development workflows, testing strategies, and documentation standards to reduce errors and rework.
  • Use case: when building a new module, refactoring, or designing a public API, follow the process to ensure high quality and long-term maintainability.

Quick Start

Provide a complete module following the development workflow: understand, architect, implement, test, and document, while enforcing SOLID and test-driven design.

Frequently Asked Questions about software-craftsman

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

FAQPage Schema
How do I enforce SOLID principles and clean architecture when building a new module?▼

Enforce SOLID principles and clean architecture by following a structured development workflow: understand requirements, architect the design, implement with design patterns, test, and document. This ensures code is modular, extensible, and maintainable.

What's the best way to refactor existing code to improve extensibility and maintainability?▼

Refactor existing code by applying SOLID, DRY, and KISS principles alongside established design patterns. This blueprint reduces errors and rework, transforming legacy scripts into robust, production-grade software with clear error handling.

How does test-driven development fit into a clean architecture workflow?▼

Test-driven development integrates into clean architecture by demanding exhaustive testing strategies during the implementation phase. This approach validates modular organization and ensures the software output remains robust and extensible over time.

Can I use these software engineering best practices across different programming languages?▼

Yes, these software engineering best practices apply across languages. The blueprint provides architecture guidance, development workflow, and documentation standards independent of specific frameworks, ensuring high-quality code in any language.

When should I not use a strict clean architecture and TDD approach for my project?▼

Avoid strict clean architecture and TDD for rapid prototyping or disposable scripts where long-term maintainability and extensibility are not required, as the comprehensive blueprint introduces overhead for immediate, short-term deliverables.

Related Skills

Explore More Software Engineering Skills→
ccfccf

software-architecture

Guide software architecture design using Clean Architecture and DDD principles.

Community
Basic
apexbusiness-systemsapexbusiness-systems
4

devops-mastery

Automate production-grade engineering practices across development, debugging, optimization, and deployment.

Community
Advanced
Abrahan-EagleAbrahan-Eagle

clean-code-principles

Apply SOLID, DRY, KISS, and ISP principles during code reviews and refactoring.

Community
Advanced
imMamdouhaboammarimMamdouhaboammar

agency-rapid-prototyper

Scaffold full-stack prototypes with Next.js, Prisma, and Supabase.

Community
Advanced