Skip to content

ComeOnOliver/skillshub / skills/aiskillstore/marketplace/0xdarkmatter/python-typing-patterns

python-typing-patterns

Verified

Python type hints and type safety patterns. Triggers on: type hints, typing, TypeVar, Generic, Protocol, mypy, pyright, type annotation, overload, TypedDict.

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-01-16T14:15:17.461Z",
    "slug": "0xdarkmatter-python-typing-patterns",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-typing-patterns",
    "source_ref": "main",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "7365b3b15c2018d2a44fe44806bbe7bbba7cdbeb375978698c6c92ae6cae0942",
    "tree_hash": "a222249d22762172fed9ecc881a478c761a081ade8c989f9188a38d517da3f9f"
  },
  "skill": {
    "name": "python-typing-patterns",
    "description": "Python type hints and type safety patterns. Triggers on: type hints, typing, TypeVar, Generic, Protocol, mypy, pyright, type annotation, overload, TypedDict.",
    "summary": "Python type hints and type safety patterns. Triggers on: type hints, typing, TypeVar, Generic, Proto...",
    "icon": "🐍",
    "version": "1.0.0",
    "author": "0xDarkMatter",
    "license": "MIT",
    "category": "documentation",
    "tags": [
      "python",
      "typing",
      "type-safety",
      "mypy",
      "pyright"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "network",
      "external_commands",
      "scripts",
      "filesystem"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "summary": "This is a documentation/reference skill containing only Python typing patterns. All 293 static findings are false positives. The scanner misidentified markdown code formatting (backticks) as shell execution, TOML config keys as cryptographic algorithms, and Python typing library names as sensitive keywords. No actual network calls, credential handling, or command execution exists.",
    "risk_factor_evidence": [
      {
        "factor": "network",
        "evidence": [
          {
            "file": "assets/pyproject-typing.toml",
            "line_start": 56,
            "line_end": 56
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 33,
            "line_end": 33
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 53,
            "line_end": 53
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 246,
            "line_end": 246
          },
          {
            "file": "references/overloads.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "references/overloads.md",
            "line_start": 45,
            "line_end": 45
          },
          {
            "file": "references/overloads.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "references/overloads.md",
            "line_start": 50,
            "line_end": 50
          },
          {
            "file": "references/overloads.md",
            "line_start": 61,
            "line_end": 61
          },
          {
            "file": "references/overloads.md",
            "line_start": 62,
            "line_end": 62
          },
          {
            "file": "references/overloads.md",
            "line_start": 51,
            "line_end": 51
          },
          {
            "file": "references/overloads.md",
            "line_start": 61,
            "line_end": 61
          },
          {
            "file": "references/overloads.md",
            "line_start": 62,
            "line_end": 62
          },
          {
            "file": "skill-report.json",
            "line_start": 6,
            "line_end": 6
          },
          {
            "file": "SKILL.md",
            "line_start": 62,
            "line_end": 62
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/generics-advanced.md",
            "line_start": 7,
            "line_end": 19
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 19,
            "line_end": 23
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 23,
            "line_end": 43
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 43,
            "line_end": 47
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 47,
            "line_end": 60
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 60,
            "line_end": 64
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 64,
            "line_end": 90
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 90,
            "line_end": 94
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 94,
            "line_end": 110
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 110,
            "line_end": 114
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 114,
            "line_end": 135
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 135,
            "line_end": 139
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 139,
            "line_end": 159
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 159,
            "line_end": 163
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 163,
            "line_end": 177
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 177,
            "line_end": 181
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 181,
            "line_end": 206
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 206,
            "line_end": 210
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 210,
            "line_end": 227
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 227,
            "line_end": 231
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 231,
            "line_end": 249
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 249,
            "line_end": 253
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 253,
            "line_end": 272
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 272,
            "line_end": 276
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 276,
            "line_end": 276
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 276,
            "line_end": 276
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 276,
            "line_end": 276
          },
          {
            "file": "references/generics-advanced.md",
            "line_start": 276,
            "line_end": 276
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 9,
            "line_end": 38
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 38,
            "line_end": 42
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 42,
            "line_end": 55
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 55,
            "line_end": 61
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 61,
            "line_end": 78
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 78,
            "line_end": 82
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 82,
            "line_end": 102
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 102,
            "line_end": 108
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 108,
            "line_end": 130
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 130,
            "line_end": 134
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 134,
            "line_end": 141
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 141,
            "line_end": 147
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 147,
            "line_end": 154
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 154,
            "line_end": 158
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 158,
            "line_end": 170
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 170,
            "line_end": 174
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 174,
            "line_end": 182
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 182,
            "line_end": 186
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 186,
            "line_end": 193
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 193,
            "line_end": 195
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 195,
            "line_end": 198
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 198,
            "line_end": 204
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 204,
            "line_end": 239
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 239,
            "line_end": 243
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 243,
            "line_end": 252
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 252,
            "line_end": 256
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 256,
            "line_end": 265
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 265,
            "line_end": 271
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 271,
            "line_end": 276
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 276,
            "line_end": 280
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 280,
            "line_end": 286
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 286,
            "line_end": 290
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 290,
            "line_end": 299
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 299,
            "line_end": 305
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 305,
            "line_end": 306
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 306,
            "line_end": 307
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 307,
            "line_end": 308
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 308,
            "line_end": 309
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 309,
            "line_end": 310
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 310,
            "line_end": 314
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 314,
            "line_end": 315
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 315,
            "line_end": 316
          },
          {
            "file": "references/mypy-config.md",
            "line_start": 316,
            "line_end": 317
          },
          {
            "file": "references/overloads.md",
            "line_start": 7,
            "line_end": 34
          },
          {
            "file": "references/overloads.md",
            "line_start": 34,
            "line_end": 38
          },
          {
            "file": "references/overloads.md",
            "line_start": 38,
            "line_end": 63
          },
          {
            "file": "references/overloads.md",
            "line_start": 63,
            "line_end": 67
          },
          {
            "file": "references/overloads.md",
            "line_start": 67,
            "line_end": 90
          },
          {
            "file": "references/overloads.md",
            "line_start": 90,
            "line_end": 94
          },
          {
            "file": "references/overloads.md",
            "line_start": 94,
            "line_end": 119
          },
          {
            "file": "references/overloads.md",
            "line_start": 119,
            "line_end": 123
          },
          {
            "file": "references/overloads.md",
            "line_start": 123,
            "line_end": 147
          },
          {
            "file": "references/overloads.md",
            "line_start": 147,
            "line_end": 151
          },
          {
            "file": "references/overloads.md",
            "line_start": 151,
            "line_end": 176
          },
          {
            "file": "references/overloads.md",
            "line_start": 176,
            "line_end": 180
          },
          {
            "file": "references/overloads.md",
            "line_start": 180,
            "line_end": 195
          },
          {
            "file": "references/overloads.md",
            "line_start": 195,
            "line_end": 199
          },
          {
            "file": "references/overloads.md",
            "line_start": 199,
            "line_end": 227
          },
          {
            "file": "references/overloads.md",
            "line_start": 227,
            "line_end": 231
          },
          {
            "file": "references/overloads.md",
            "line_start": 231,
            "line_end": 255
          },
          {
            "file": "references/overloads.md",
            "line_start": 255,
            "line_end": 261
          },
          {
            "file": "references/overloads.md",
            "line_start": 261,
            "line_end": 262
          },
          {
            "file": "references/overloads.md",
            "line_start": 262,
            "line_end": 263
          },
          {
            "file": "references/overloads.md",
            "line_start": 263,
            "line_end": 263
          },
          {
            "file": "references/overloads.md",
            "line_start": 263,
            "line_end": 268
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 7,
            "line_end": 28
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 28,
            "line_end": 32
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 32,
            "line_end": 52
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 52,
            "line_end": 56
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 56,
            "line_end": 74
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 74,
            "line_end": 78
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 78,
            "line_end": 97
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 97,
            "line_end": 101
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 101,
            "line_end": 129
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 129,
            "line_end": 133
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 133,
            "line_end": 150
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 150,
            "line_end": 154
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 154,
            "line_end": 182
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 182,
            "line_end": 188
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 188,
            "line_end": 196
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 196,
            "line_end": 200
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 200,
            "line_end": 212
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 212,
            "line_end": 216
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 216,
            "line_end": 232
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 232,
            "line_end": 238
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 238,
            "line_end": 274
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 274,
            "line_end": 278
          },
          {
            "file": "references/protocols-patterns.md",
            "line_start": 278,
            "line_end": 307
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 7,
            "line_end": 44
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 44,
            "line_end": 48
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 48,
            "line_end": 67
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 67,
            "line_end": 71
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 71,
            "line_end": 105
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 105,
            "line_end": 109
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 109,
            "line_end": 133
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 133,
            "line_end": 137
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 137,
            "line_end": 159
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 159,
            "line_end": 163
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 163,
            "line_end": 183
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 183,
            "line_end": 187
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 187,
            "line_end": 214
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 214,
            "line_end": 218
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 218,
            "line_end": 245
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 245,
            "line_end": 255
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 255,
            "line_end": 280
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 280,
            "line_end": 286
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 286,
            "line_end": 286
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 286,
            "line_end": 287
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 287,
            "line_end": 287
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 287,
            "line_end": 288
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 288,
            "line_end": 292
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 292,
            "line_end": 292
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 292,
            "line_end": 293
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 293,
            "line_end": 293
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 293,
            "line_end": 294
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 294,
            "line_end": 294
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 294,
            "line_end": 295
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 295,
            "line_end": 296
          },
          {
            "file": "references/runtime-validation.md",
            "line_start": 296,
            "line_end": 297
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 7,
            "line_end": 18
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 18,
            "line_end": 22
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 22,
            "line_end": 35
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 35,
            "line_end": 39
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 39,
            "line_end": 49
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 49,
            "line_end": 53
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 53,
            "line_end": 79
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 79,
            "line_end": 83
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 83,
            "line_end": 95
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 95,
            "line_end": 99
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 99,
            "line_end": 119
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 119,
            "line_end": 123
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 123,
            "line_end": 134
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 134,
            "line_end": 138
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 138,
            "line_end": 150
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 150,
            "line_end": 154
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 154,
            "line_end": 164
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 164,
            "line_end": 168
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 168,
            "line_end": 186
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 186,
            "line_end": 190
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 190,
            "line_end": 208
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 208,
            "line_end": 212
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 212,
            "line_end": 230
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 230,
            "line_end": 236
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 236,
            "line_end": 248
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 248,
            "line_end": 252
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 252,
            "line_end": 262
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 262,
            "line_end": 268
          },
          {
            "file": "references/type-narrowing.md",
            "line_start": 268,
            "line_end": 268
          },
          {
            "file": "scripts/check-types.sh",
            "line_start": 87,
            "line_end": 87
          },
          {
            "file": "scripts/check-types.sh",
            "line_start": 1,
            "line_end": 1
          },
          {
            "file": "SKILL.md",
            "line_start": 16,
            "line_end": 30
          },
          {
            "file": "SKILL.md",
            "line_start": 30,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 49
          },
          {
            "file": "SKILL.md",
            "line_start": 49,
            "line_end": 53
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 86
          },
          {
            "file": "SKILL.md",
            "line_start": 86,
            "line_end": 90
          },
          {
            "file": "SKILL.md",
            "line_start": 90,
            "line_end": 105
          },
          {
            "file": "SKILL.md",
            "line_start": 105,
            "line_end": 109
          },
          {
            "file": "SKILL.md",
            "line_start": 109,
            "line_end": 124
          },
          {
            "file": "SKILL.md",
            "line_start": 124,
            "line_end": 128
          },
          {
            "file": "SKILL.md",
            "line_start": 128,
            "line_end": 143
          },
          {
            "file": "SKILL.md",
            "line_start": 143,
            "line_end": 147
          },
          {
            "file": "SKILL.md",
            "line_start": 147,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 161
          },
          {
            "file": "SKILL.md",
            "line_start": 161,
            "line_end": 172
          },
          {
            "file": "SKILL.md",
            "line_start": 172,
            "line_end": 178
          },
          {
            "file": "SKILL.md",
            "line_start": 178,
            "line_end": 179
          },
          {
            "file": "SKILL.md",
            "line_start": 179,
            "line_end": 180
          },
          {
            "file": "SKILL.md",
            "line_start": 180,
            "line_end": 181
          },
          {
            "file": "SKILL.md",
            "line_start": 181,
            "line_end": 182
          },
          {
            "file": "SKILL.md",
            "line_start": 182,
            "line_end": 183
          },
          {
            "file": "SKILL.md",
            "line_start": 183,
            "line_end": 184
          },
          {
            "file": "SKILL.md",
            "line_start": 184,
            "line_end": 185
          },
          {
            "file": "SKILL.md",
            "line_start": 185,
            "line_end": 186
          },
          {
            "file": "SKILL.md",
            "line_start": 186,
            "line_end": 190
          },
          {
            "file": "SKILL.md",
            "line_start": 190,
            "line_end": 201
          },
          {
            "file": "SKILL.md",
            "line_start": 201,
            "line_end": 205
          },
          {
            "file": "SKILL.md",
            "line_start": 205,
            "line_end": 206
          },
          {
            "file": "SKILL.md",
            "line_start": 206,
            "line_end": 207
          },
          {
            "file": "SKILL.md",
            "line_start": 207,
            "line_end": 208
          },
          {
            "file": "SKILL.md",
            "line_start": 208,
            "line_end": 209
          },
          {
            "file": "SKILL.md",
            "line_start": 209,
            "line_end": 210
          },
          {
            "file": "SKILL.md",
            "line_start": 210,
            "line_end": 214
          },
          {
            "file": "SKILL.md",
            "line_start": 214,
            "line_end": 218
          },
          {
            "file": "SKILL.md",
            "line_start": 218,
            "line_end": 227
          },
          {
            "file": "SKILL.md",
            "line_start": 227,
            "line_end": 230
          },
          {
            "file": "SKILL.md",
            "line_start": 230,
            "line_end": 231
          },
          {
            "file": "SKILL.md",
            "line_start": 231,
            "line_end": 232
          }
        ]
      },
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "references/runtime-validation.md",
            "line_start": 219,
            "line_end": 226
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "scripts/check-types.sh",
            "line_start": 54,
            "line_end": 54
          },
          {
            "file": "scripts/check-types.sh",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "scripts/check-types.sh",
            "line_start": 87,
            "line_end": 87
          }
        ]
      }
    ],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 10,
    "total_lines": 2545,
    "audit_model": "claude",
    "audited_at": "2026-01-16T14:15:17.461Z"
  },
  "content": {
    "user_title": "Apply Python Type Hints Effectively",
    "value_statement": "Python type hints improve code quality and catch bugs early. This skill provides patterns for TypeVar, Generic, Protocol, TypedDict, and runtime validation with Pydantic and typeguard.",
    "seo_keywords": [
      "python typing patterns",
      "python type hints",
      "TypeVar Generic",
      "Protocol Python",
      "mypy configuration",
      "pyright",
      "TypedDict patterns",
      "runtime type validation",
      "Claude Code",
      "Python Codex"
    ],
    "actual_capabilities": [
      "Shows Python type annotation syntax for variables, functions, and classes",
      "Explains TypeVar, Generic, Protocol, and ParamSpec for flexible types",
      "Demonstrates TypedDict for type-safe dictionary access",
      "Covers mypy and pyright configuration for strict type checking",
      "Provides runtime validation patterns using Pydantic, typeguard, and beartype"
    ],
    "limitations": [
      "Does not include type checker installation or execution",
      "Does not modify user source code automatically",
      "Does not integrate with IDEs or build systems directly",
      "Requires Python 3.10+ for modern union syntax"
    ],
    "use_cases": [
      {
        "target_user": "Python developers",
        "title": "Add type hints to code",
        "description": "Learn correct syntax for type annotations in Python 3.10+ including generics and protocols."
      },
      {
        "target_user": "Library maintainers",
        "title": "Design type-safe APIs",
        "description": "Create flexible APIs using TypeVar and Protocol for structural typing without inheritance."
      },
      {
        "target_user": "Backend developers",
        "title": "Validate API data",
        "description": "Use Pydantic and typeguard to enforce types at runtime for API requests and config."
      }
    ],
    "prompt_templates": [
      {
        "title": "Basic typing syntax",
        "scenario": "Learning type annotations",
        "prompt": "Show me how to write type hints for a function that takes a list of strings and returns an integer."
      },
      {
        "title": "Generic functions",
        "scenario": "Creating reusable functions",
        "prompt": "How do I use TypeVar to create a function that works with any type but preserves the type information?"
      },
      {
        "title": "Protocol pattern",
        "scenario": "Structural typing",
        "prompt": "Explain how Protocol works in Python and show an example where an object without inheritance satisfies an interface."
      },
      {
        "title": "Runtime validation",
        "scenario": "API data validation",
        "prompt": "How do I validate function arguments at runtime using Pydantic v2 with field constraints?"
      }
    ],
    "output_examples": [
      {
        "input": "How do I type a function that returns the same type as its input?",
        "output": [
          "Use TypeVar to preserve the input type:",
          "```python",
          "from typing import TypeVar",
          "T = TypeVar('T')",
          "def identity(x: T) -> T:",
          "    return x",
          "```",
          "Result: identity(42) returns int, identity('hello') returns str"
        ]
      },
      {
        "input": "How do I validate that a user email is valid at runtime?",
        "output": [
          "Use Pydantic with EmailStr:",
          "```python",
          "from pydantic import BaseModel, EmailStr",
          "class User(BaseModel):",
          "    email: EmailStr",
          "```",
          "This automatically validates and normalizes email addresses when creating User instances."
        ]
      }
    ],
    "best_practices": [
      "Use Python 3.10+ union syntax (X | Y) instead of Optional[X] for clarity",
      "Prefer Protocol over ABC for structural typing to allow duck typing",
      "Enable strict mode in mypy or pyright to catch issues early"
    ],
    "anti_patterns": [
      "Using Any extensively defeats the purpose of type checking",
      "Avoid quotes around forward references (use from __future__ import annotations)",
      "Do not mix Optional[X] with X | None inconsistently in the same codebase"
    ],
    "faq": [
      {
        "question": "What Python version do I need?",
        "answer": "Python 3.10+ for union syntax. Python 3.11+ for Self and TypeVarTuple."
      },
      {
        "question": "mypy vs pyright?",
        "answer": "mypy is slower but mature. pyright is faster with better IDE integration."
      },
      {
        "question": "Type hints slow?",
        "answer": "No, type hints are stripped at runtime. Runtime validation adds overhead."
      },
      {
        "question": "TypedDict vs dict?",
        "answer": "TypedDict validates keys exist. Regular dict allows any keys with any types."
      },
      {
        "question": "Protocol inheritance?",
        "answer": "Protocol uses structural typing. No explicit inheritance needed."
      },
      {
        "question": "Required vs NotRequired?",
        "answer": "Required keys must exist. NotRequired keys are optional in TypedDict."
      }
    ]
  },
  "file_structure": [
    {
      "name": "assets",
      "type": "dir",
      "path": "assets",
      "children": [
        {
          "name": "pyproject-typing.toml",
          "type": "file",
          "path": "assets/pyproject-typing.toml",
          "lines": 118
        }
      ]
    },
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "generics-advanced.md",
          "type": "file",
          "path": "references/generics-advanced.md",
          "lines": 283
        },
        {
          "name": "mypy-config.md",
          "type": "file",
          "path": "references/mypy-config.md",
          "lines": 318
        },
        {
          "name": "overloads.md",
          "type": "file",
          "path": "references/overloads.md",
          "lines": 272
        },
        {
          "name": "protocols-patterns.md",
          "type": "file",
          "path": "references/protocols-patterns.md",
          "lines": 317
        },
        {
          "name": "runtime-validation.md",
          "type": "file",
          "path": "references/runtime-validation.md",
          "lines": 298
        },
        {
          "name": "type-narrowing.md",
          "type": "file",
          "path": "references/type-narrowing.md",
          "lines": 272
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": "check-types.sh",
          "type": "file",
          "path": "scripts/check-types.sh",
          "lines": 152
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 233
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall