python-type-safety SKILL.md skillA
python-type-safety from wshobson/agents is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add wshobson/agents/python-type-safety@git:20260522.be57c0bPins git:20260522.be57c0b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- wshobson/agents
- Path
plugins/python-development/skills/python-type-safety/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260522.be57c0b, committed May 22, 2026
- First version recorded
- Jan 30, 2026
- Size
- 5,763 bytes
- Repository stars
- 42,320
- License
- MIT
Python type safety with type hints, generics, protocols, and strict type checking. Use when adding type annotations, implementing generic classes, defining structural interfaces, or configuring mypy/pyright.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Python Type Safety
Leverage Python's type system to catch errors at static analysis time. Type annotations serve as enforced documentation that tooling validates automatically.
## When to Use This Skill
- Adding type hints to existing code
- Creating generic, reusable classes
- Defining structural interfaces with protocols
- Configuring mypy or pyright for strict checking
- Understanding type narrowing and guards
- Building type-safe APIs and libraries
## Core Concepts
### 1. Type Annotations
Declare expected types for function parameters, return values, and variables.
### 2. Generics
Write reusable code that preserves type information across different types.
### 3. Protocols
Define structural interfaces without inheritance (duck typing with type safety).
### 4. Type Narrowing
Use guards and conditionals to narrow types within code blocks.
## Quick Start
```python
def get_user(user_id: str) -> User | None:
"""Return type makes 'might not exist' explicit."""
...
# Type checker enforces handling None case
user = get_user("123")
if user is None:
raise UserNotFoundError("123")
print(user.name) # Type checker knows user is User here
```
…Read the whole file at its exact version.
How to install
mdr add wshobson/agents/python-type-safety@sha256:7798dd109350b73cThe line at the top of this page pins the label git:20260522.be57c0b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_dhbxuvo3msetsuq7)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Jan 30, 2026 and May 22, 2026, about one every 37 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260522.be57c0b latest | 2026-05-22 | be57c0b | 5,763 B | A | view · diff |
| git:20260326.344a912 | 2026-03-26 | 344a912 | 11,376 B | A | view · diff |
| git:20260326.00ccc3f | 2026-03-26 | 00ccc3f | 11,348 B | A | view · diff |
| git:20260130.cbb6049 | 2026-01-30 | cbb6049 | 11,234 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5763 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
wshobson/agents · 42,320 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dhbxuvo3msetsuq7 GET https://markdownregistry.com/api/v1/resolve?ref=wshobson/agents/python-type-safety GET https://markdownregistry.com/api/v1/blob/7798dd109350b73c80bb4642f6e5a0ebaa2ae392484a213d4b44b35e9b4dad66
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.