TY

type-design-analysis

Analyzes type system design robustness, encapsulation, and invariant integrity.

Install

mkdir -p .claude/skills/type-design-analysis && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10215" && unzip -o skill.zip -d .claude/skills/type-design-analysis && rm skill.zip

Installs to .claude/skills/type-design-analysis

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

型設計の品質と不変性を4軸スコアで分析する。interface, type, class の追加・変更時に使用。
56 charsno explicit “when” trigger
Advanced

Key capabilities

  • Analyze type encapsulation
  • Evaluate invariant expression
  • Assess invariant usefulness
  • Detect anti-patterns

How it works

Scores type designs across four axes and identifies common anti-patterns like anemic domain models.

Inputs & outputs

You give it
TypeScript interface or class
You get back
Quality score and improvement suggestions

When to use type-design-analysis

  • Review type definition quality
  • Detect weak type encapsulation
  • Improve type-level invariant safety
  • Refactor interfaces and classes

About this skill

Type Design Analysis スキル

目的

型設計の品質と不変性を分析し、堅牢な型システムの構築を支援する。

評価軸(各1-10スコア)

1. Encapsulation(カプセル化)

  • 10: 完全なカプセル化、内部状態へのアクセス不可
  • 7-9: ほぼ完全、一部のgetter/setterあり
  • 4-6: 部分的、一部の内部が露出
  • 1-3: 不十分、内部が広く公開

チェックポイント: privateフィールド、readonly修飾子、getter/setter

2. Invariant Expression(不変性表現)

  • 10: すべての不変性が型で表現
  • 7-9: 主要な不変性が型で表現
  • 4-6: 一部の不変性のみ
  • 1-3: ドキュメントのみに依存

チェックポイント: Union型、Branded型、型ガード

3. Invariant Usefulness(不変性の有用性)

  • 10: クリティカルなビジネスルールを保護
  • 7-9: 重要なエラーを防止
  • 4-6: 一般的なミスを防止
  • 1-3: 限定的な保護

4. Invariant Enforcement(不変性の強制)

  • 10: 構築時と全変異点で検証
  • 7-9: 構築時に検証、変異は制限
  • 4-6: 部分的な検証
  • 1-3: 検証なし、信頼ベース

アンチパターン(検出して報告)

  1. 貧血ドメインモデル - データのみで振る舞いがない型
  2. 変更可能な内部の公開 - 配列やオブジェクトを直接公開
  3. ドキュメント依存の不変性 - 型ではなくコメントで制約を表現
  4. 過度に広い責任 - 1つの型に多すぎる責任
  5. 構築境界での検証不足 - 無効な状態で構築可能

出力形式

# Type Design Analysis Results

## [型名]

- ファイル: path/to/file.ts

| 軸 | スコア | 理由 |
|----|--------|------|
| Encapsulation | X/10 | ... |
| Invariant Expression | X/10 | ... |
| Invariant Usefulness | X/10 | ... |
| Invariant Enforcement | X/10 | ... |

- 総合スコア: X/10
- 検出されたアンチパターン: ...
- 改善提案: ...

## Summary

- 分析した型の数: X
- 平均スコア: X/10
- 検出されたアンチパターン: X

注意事項

  • 新規追加または変更された型のみを分析
  • 4つの軸すべてでスコアを付与
  • 具体的な改善提案を含める

When not to use it

  • Analyzing non-TypeScript code

Limitations

  • Requires manual review of logic
  • Limited to TypeScript

How it compares

Provides a quantitative score for type design quality instead of just linting for syntax.

Compared to similar skills

type-design-analysis side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
type-design-analysis (this skill)06moNo flagsAdvanced
typescript-review392moNo flagsIntermediate
typescript282moNo flagsBeginner
react-patterns96moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry