Can this skill help with error handling?

Yes, it provides principles for 'defining errors out of existence' by changing method semantics so that common edge cases are handled internally rather than thrown as exceptions.

What are 'Deep Modules' in software design?

A deep module is an abstraction that provides a lot of functionality through a very simple interface, like the Unix I/O system, as opposed to shallow modules where the interface is as complex as the implementation.

How does this skill help with technical debt?

It promotes 'Strategic Programming' over 'Tactical Programming,' encouraging a 10-20% time investment in design improvements to prevent change amplification and high cognitive load.

What is the core philosophy behind this System Design skill?

It is based on 'A Philosophy of Software Design' by John Ousterhout, which posits that complexity is the root of most software problems and focuses on creating 'deep' modules that hide complexity behind simple interfaces.

System Design Principles

Name: System Design Principles
Author: primeinc

byprimeinc

0•

API開発

Applies high-level architectural principles to create deep modules, reduce system complexity, and build maintainable software interfaces.

The System Design skill equips Claude with the architectural framework established in John Ousterhout’s 'A Philosophy of Software Design.' It helps developers move beyond simply writing 'working code' toward building 'great design' by focusing on deep modules with simple interfaces, aggressive information hiding, and the elimination of unnecessary complexity. Whether you are designing a new API, refactoring a monolithic service, or building a CLI tool, this skill provides actionable guidance on reducing cognitive load and change amplification through strategic programming and better abstraction boundaries.

主な機能

010 GitHub stars

02Strategic vs. Tactical programming analysis for long-term project health

03Error-elimination techniques to simplify API surfaces and internal logic

04Identification of shallow modules and refactoring patterns for deep modules

05Information hiding strategies to prevent implementation leakage and coupling

06Red flag detection for common architectural pitfalls like temporal decomposition

ユースケース

01Designing a new library or API with a clean, minimal interface for high reusability

02Refactoring complex legacy codebases to reduce cognitive load and technical debt

03Building CLI tools with sensible defaults and progressive disclosure for better UX

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add primeinc/swarm system-design

For use in Claude.ai and ChatGPT

Download Skill