skills.rest
gotgenes
gotgenesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

code-design

Apply SOLID and self-documenting guidelines to TypeScript code.

143|52|Updated May 15, 2026
Search Tags:#typescript#refactoring#eslint#solid#self-documenting#software-architecture#code-design
One-click install
npx skills add https://github.com/gotgenes/pi-packages --skill code-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-design
Source: https://github.com/gotgenes/pi-packages/tree/main/.pi/skills/code-design
Command: npx skills add https://github.com/gotgenes/pi-packages --skill code-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebases often struggle with maintaining TypeScript clarity, consistent design, and scalable organization as they grow, leading to confusion and technical debt.

Core Features & Use Cases

  • Enforces SOLID and self-documenting coding practices to improve readability and maintainability.
  • Provides guidance on code organization, naming, and public API design to reduce churn during refactors and reviews.
  • Useful during implementation, refactoring, or code review across TypeScript projects in Pi SDK workflows.

Quick Start

Start by outlining public API surfaces, then organize modules with a top-level public API first approach and rename symbols for clarity.

Frequently Asked Questions about code-design

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

FAQPage Schema
How do I enforce SOLID principles during TypeScript refactoring?▼

TypeScript refactoring enforces SOLID principles by applying a public API-first design, stepwise function layout, clear naming, and minimal private helpers to improve code maintainability and reduce technical debt.

What is the best way to structure self-documenting TypeScript modules?▼

Self-documenting TypeScript modules require outlining public API surfaces first, organizing modules with a top-level public API approach, and renaming symbols for clarity to ensure disciplined module boundaries.

Can I use Biome and ESLint constraints for TypeScript code reviews?▼

Biome and ESLint constraints apply to TypeScript code reviews by enforcing well-structured organization guidelines, ES2024 compliance, and disciplined module boundaries across Pi SDK workflows.

How to reduce code churn during TypeScript implementation with pnpm workflows?▼

Reducing code churn during TypeScript implementation involves applying SOLID coding practices, designing public API surfaces first, and maintaining disciplined module boundaries within pnpm workflows.

When do I need a public API-first design in software architecture?▼

Public API-first design is needed in software architecture when codebases struggle with maintaining TypeScript clarity, consistent design, and scalable organization as they grow, leading to confusion and technical debt.

Related Skills

Explore More Software Engineering Skills→
mauriciodelriomauriciodelrio
3

code-quality-rules

Configure ESLint, Prettier, or Biome with strict linting rules for React projects.

Community
Advanced
404-Profit-Not-Found404-Profit-Not-Found

clean-code

Enforce pragmatic coding standards for maintainable AI-assisted code across routine tasks.

Official
Basic
vanducngvanducng
5

apidesign

Define and validate stable API contracts for REST and GraphQL surfaces.

Community
Advanced
DoubleslashSEDoubleslashSE
4

clean-code

Apply DRY, KISS, and YAGNI principles to write and review C# code.

Community
Basic