Type Hints — Claude Code skill: what it does, how to install
Type Hints — a skill that walks the agent through Python annotations and mypy setup, from function signatures to Protocol, TypedDict and strict mode.
LicenseRef-Proprietary 128 installs ★ 7 updated 2026-01-05
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-codeWhat Type Hints does
The skill covers annotated Python end to end. Basic annotations come first: variables, function signatures, return types, Optional and Union. Then the advanced layer: generics, TypeVar, ParamSpec, Protocol, Literal, TypedDict.
Type checking gets a section of its own — mypy config, strict settings, # type: ignore comments, .pyi stub files and type coverage. Runtime typing follows: typing_extensions, Pydantic validation, typed dataclasses, attrs. The last block is practice: gradual adoption, stubs for third-party packages, checking in CI.
It is bonded to the 07-best-practices agent, so the material feeds code-review work rather than teaching syntax from scratch. Python and OOP basics are a prerequisite here. TypeVar and Protocol assume you already read ordinary class code.
What it helps with
- Annotate a legacy module without rewriting its logic
- Switch mypy to strict and clear out stale
# type: ignorelines - Describe an interface as a Protocol instead of a base class
- Add a type check step to CI
- Write stubs for a library that ships none
Example prompts for the agent
- Go through
billing.pyand add type hints to the public functions. - Why does mypy reject this
Optional? Show the strict-mode fix. - Replace this
dictwith aTypedDictand tell me what changes.
How to install Type Hints
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-code2Manually: put the files in place
~/.claude/skills/type-hints/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/type-hints/
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a codex2Manually: put the files in place
.agents/skills/type-hints/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a cursor2Manually: put the files in place
.cursor/skills/type-hints/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pluginagentmarketplace/custom-plugin-python skills/type-hints2Manually: put the files in place
.github/skills/type-hints/SKILL.md1Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a gemini-cli2Platform CLI
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-python --path skills/type-hintsManually: put the files in place
.devin/skills/type-hints/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Type Hints
How do I install Type Hints in Claude Code?
Run npx skills add pluginagentmarketplace/custom-plugin-python --skill type-hints -a claude-code. The skill lands at ~/.claude/skills/type-hints/SKILL.md.
What does Type Hints do?
It guides the agent through Python type annotations and static analysis with mypy: generics, Protocol, TypedDict, mypy configuration, runtime typing.
What should I know before using it?
Python and OOP fundamentals. The TypeVar and structural typing parts build on classes and interfaces rather than starting from syntax.