skills.rest
tomzx
tomzxCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

find-type-gaps

Detect and rank missing type annotations in Python, TypeScript, and JavaScript codebases.

5|Updated Jul 25, 2025
Search Tags:#typescript#python#javascript#code-quality#static-analysis#type-checking#gap-analysis
One-click install
npx skills add https://github.com/tomzx/agents --skill find-type-gaps
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: find-type-gaps
Source: https://github.com/tomzx/agents/tree/main/skills/find-type-gaps
Command: npx skills add https://github.com/tomzx/agents --skill find-type-gaps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Find Type Gaps skill identifies missing or incomplete type annotations in gradually-typed languages (Python, TypeScript, JavaScript) and prioritizes gaps by public visibility and churn to help teams improve type safety.

Core Features & Use Cases

  • Detects language and determines applicable typing gaps for Python, TypeScript, and JavaScript
  • Measures and reports on type coverage using mypy/pyright or tsc, with per-file insights
  • Ranks gaps by impact (public API, churn) and suggests concrete annotations
  • Helps teams prepare CI checks and incremental improvements

Quick Start

Run the find-type-gaps skill on your codebase to generate a prioritized plan of type-annotation fixes.

Frequently Asked Questions about find-type-gaps

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

FAQPage Schema
How do I find missing type annotations in a Python or TypeScript codebase?▼

To find missing type annotations, the skill analyzes gradually-typed Python, TypeScript, and JavaScript codebases to detect language, measure type coverage using mypy, pyright, or tsc, and output a prioritized list of gaps in public APIs and core modules.

What is the best way to prioritize type checking fixes in a gradually-typed codebase?▼

Prioritizing type checking fixes is done by ranking missing type annotations based on public visibility and code churn. This surfaces high-impact gaps in exported interfaces first, providing a concrete start-up plan for incremental improvements.

How do I measure type coverage and generate a plan for incremental typing?▼

You can measure type coverage by running static analysis tools like mypy, pyright, or tsc across your repository. The skill provides per-file insights and translates them into concrete annotation recommendations and a CI preparation plan.

Does this type gap analysis work for JavaScript and TypeScript projects?▼

Yes, this type gap analysis works for JavaScript and TypeScript projects by leveraging tsc to measure type coverage. It detects applicable typing gaps and prioritizes them by impact to help improve type safety across mixed-typing repositories.

Can I use mypy or pyright to identify untyped public APIs in Python?▼

Yes, you can use mypy or pyright to identify untyped public APIs in Python. The skill utilizes these tools to measure per-file type coverage and ranks the gaps specifically by public surface visibility to highlight core module issues.

Related Skills

Explore More Software Engineering Skills→
wesleyegbertowesleyegberto
3

python-type-safety

Enforce strict Python type safety with mypy and pyright static analysis.

Community
Advanced
Sanali209Sanali209

python-code-review

Analyze Python code for type hints, async usage, and error handling issues.

Community
Intermediate
dousudousu
3

type-safety-enforcer

Enforce strict type safety and documentation standards in Python projects with mypy and linters.

Community
Intermediate
Ilenburg1993Ilenburg1993
3

typescript-typing

Add TypeScript typing to JavaScript codebases using JSDoc and declaration files.

Community
Intermediate