What are domain-specific types?

They are type aliases that map basic data types, such as strings, lists, or tuples, to domain-specific names like 'City', 'Order', or 'Point' to make code more readable.

When should I avoid using this skill?

It is best to avoid it for very simple scripts with obvious data types or in cases where adding type aliases would introduce more visual noise than actual semantic clarity.

How does this skill improve Claude's output?

It instructs Claude to define a semantic vocabulary at the top of the file, ensuring all subsequently generated functions use descriptive, domain-relevant signatures instead of generic types.

Is this compatible with standard Python typing?

Yes, it leverages standard PEP 484 type hints and type aliasing, ensuring full compatibility with static analysis tools like Mypy and modern IDEs.

Can I use this for languages other than Python?

While the core pattern is demonstrated in Python, the logic of defining semantic type aliases applies to any language with a robust type system, such as TypeScript, Go, or Rust.

Domain-Specific Type Aliasing

Name: Domain-Specific Type Aliasing
Author: jimmc414

byjimmc414

•

学习与文档

Improves code readability by establishing a domain-specific vocabulary through clear type aliases.

Inspired by Peter Norvig's coding style, this skill guides Claude in establishing a domain-specific vocabulary at the start of new modules. By defining type aliases that represent real-world entities—such as 'Point', 'Grid', or 'Score'—it transforms standard function signatures into self-documenting prose. This approach reduces cognitive load for developers and ensures that complex data structures are consistently understood and utilized throughout the codebase, making it ideal for modeling intricate problem domains or building mini-DSLs.

主要功能

01Standardizes module-level headers for better documentation

02Supports gradual typing for complex nested data structures

03Minimizes code noise by focusing on business logic meanings

04Enhances function signature readability and clarity

051 GitHub stars

06Establishes domain vocabulary using semantic type aliases

使用场景

01Starting a new project with complex data structures like graphs, grids, or coordinate systems

02Building domain-specific languages (DSLs) where code needs to read like natural language

03Refactoring existing modules to improve maintainability and team communication

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimmc414/claude-code-plugin-marketplace define-domain-types

For use in Claude.ai and ChatGPT

Download Skill