Skip to content

aiskillstore/marketplace / skills/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-07-09T01:12:44.122Z",
    "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": "9ac23c145eaa181c937372c00bd14bf91ea926df96d7906924c4239132c71c5e",
    "provenance": {
      "model_requested": "claude-sonnet-4.6",
      "model_effective": "claude:claude-sonnet-4.6",
      "fallback_chain": [
        {
          "agent": "claude",
          "model": "claude-sonnet-4.6",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "python-typing-patterns",
    "description": "Python typing reference for adding type hints, generics, protocols, overloads, runtime validation, and strict mypy or pyright checks.",
    "summary": "Add and validate modern Python type hints with practical examples for mypy, pyright, protocols, overloads, and runtime validation.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "python",
      "typing",
      "mypy",
      "pyright",
      "type-safety"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "network",
      "scripts",
      "external_commands",
      "filesystem"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All static findings were adjudicated as false positives after reviewing the referenced files. The skill contains Python typing documentation, sample configuration, and a local type-checking helper script; no prompt injection, credential theft, data exfiltration, or malicious system behavior was found.",
    "remediation": [
      {
        "issue": "Documentation examples resemble network calls and command usage to pattern scanners.",
        "suggestion": "Label code blocks as examples and clarify that URLs such as api.example.com are placeholders that users must replace intentionally.",
        "severity": "low"
      },
      {
        "issue": "The shell helper creates a temporary pyright configuration file.",
        "suggestion": "Add a trap to remove the temporary file on interruption so cleanup is reliable in all exit paths.",
        "severity": "low"
      }
    ],
    "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.md",
            "line_start": 62,
            "line_end": 62
          }
        ]
      },
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "references/runtime-validation.md",
            "line_start": 219,
            "line_end": 226
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "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": "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
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "network:assets/pyproject-typing.toml:56:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "assets/pyproject-typing.toml",
        "line_start": 56,
        "line_end": 56,
        "snippet": "\"requests.*\","
      },
      {
        "id": "sensitive:references/generics-advanced.md:102:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "references/generics-advanced.md",
        "line_start": 102,
        "line_end": 102,
        "snippet": "self.key = key"
      },
      {
        "id": "sensitive:references/generics-advanced.md:106:certificate-key-files",
        "category": "sensitive",
        "severity": "high",
        "pattern": "Certificate/key files",
        "file": "references/generics-advanced.md",
        "line_start": 106,
        "line_end": 106,
        "snippet": "return Pair(self.value, self.key)"
      },
      {
        "id": "blocker:references/generics-advanced.md:266:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/generics-advanced.md",
        "line_start": 266,
        "line_end": 266,
        "snippet": "user_id = UserId(42)"
      },
      {
        "id": "blocker:references/generics-advanced.md:267:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/generics-advanced.md",
        "line_start": 267,
        "line_end": 267,
        "snippet": "order_id = OrderId(42)"
      },
      {
        "id": "network:references/mypy-config.md:33:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/mypy-config.md",
        "line_start": 33,
        "line_end": 33,
        "snippet": "\"requests.*\","
      },
      {
        "id": "network:references/mypy-config.md:53:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/mypy-config.md",
        "line_start": 53,
        "line_end": 53,
        "snippet": "[mypy-requests.*]"
      },
      {
        "id": "network:references/mypy-config.md:246:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/mypy-config.md",
        "line_start": 246,
        "line_end": 246,
        "snippet": "- repo: https://github.com/pre-commit/mirrors-mypy"
      },
      {
        "id": "network:references/overloads.md:42:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 42,
        "line_end": 42,
        "snippet": "def fetch(url: str, format: Literal[\"json\"]) -> dict: ..."
      },
      {
        "id": "network:references/overloads.md:45:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 45,
        "line_end": 45,
        "snippet": "def fetch(url: str, format: Literal[\"text\"]) -> str: ..."
      },
      {
        "id": "network:references/overloads.md:48:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "def fetch(url: str, format: Literal[\"bytes\"]) -> bytes: ..."
      },
      {
        "id": "network:references/overloads.md:50:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 50,
        "line_end": 50,
        "snippet": "def fetch(url: str, format: str) -> dict | str | bytes:"
      },
      {
        "id": "network:references/overloads.md:61:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 61,
        "line_end": 61,
        "snippet": "data = fetch(\"https://api.example.com\", \"json\")  # dict"
      },
      {
        "id": "network:references/overloads.md:62:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "references/overloads.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "text = fetch(\"https://api.example.com\", \"text\")  # str"
      },
      {
        "id": "network:references/overloads.md:51:python-http-libraries",
        "category": "network",
        "severity": "low",
        "pattern": "Python HTTP libraries",
        "file": "references/overloads.md",
        "line_start": 51,
        "line_end": 51,
        "snippet": "response = requests.get(url)"
      },
      {
        "id": "network:references/overloads.md:61:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/overloads.md",
        "line_start": 61,
        "line_end": 61,
        "snippet": "data = fetch(\"https://api.example.com\", \"json\")  # dict"
      },
      {
        "id": "network:references/overloads.md:62:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/overloads.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "text = fetch(\"https://api.example.com\", \"text\")  # str"
      },
      {
        "id": "blocker:references/protocols-patterns.md:44:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/protocols-patterns.md",
        "line_start": 44,
        "line_end": 44,
        "snippet": "self.id = id"
      },
      {
        "id": "blocker:references/protocols-patterns.md:286:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/protocols-patterns.md",
        "line_start": 286,
        "line_end": 286,
        "snippet": "self.user_id = user_id"
      },
      {
        "id": "scripts:references/runtime-validation.md:219:dynamic-import-expression",
        "category": "scripts",
        "severity": "medium",
        "pattern": "Dynamic import() expression",
        "file": "references/runtime-validation.md",
        "line_start": 219,
        "line_end": 226,
        "snippet": "from pydantic import ("
      },
      {
        "id": "blocker:references/runtime-validation.md:32:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 32,
        "line_end": 32,
        "snippet": "# Usage - raises ValidationError on invalid data"
      },
      {
        "id": "blocker:references/runtime-validation.md:60:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 60,
        "line_end": 61,
        "snippet": "# Valid"
      },
      {
        "id": "blocker:references/runtime-validation.md:64:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 64,
        "line_end": 64,
        "snippet": "# Invalid - raises ValidationError"
      },
      {
        "id": "blocker:references/runtime-validation.md:80:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 80,
        "line_end": 81,
        "snippet": "# Valid"
      },
      {
        "id": "blocker:references/runtime-validation.md:83:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 83,
        "line_end": 83,
        "snippet": "# Invalid - raises TypeCheckError at runtime"
      },
      {
        "id": "blocker:references/runtime-validation.md:150:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 150,
        "line_end": 151,
        "snippet": "# Valid"
      },
      {
        "id": "blocker:references/runtime-validation.md:153:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 153,
        "line_end": 153,
        "snippet": "# Invalid - raises ValidationError"
      },
      {
        "id": "blocker:references/runtime-validation.md:296:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 296,
        "line_end": 296,
        "snippet": "| `EmailStr` | Valid email |"
      },
      {
        "id": "blocker:references/runtime-validation.md:297:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/runtime-validation.md",
        "line_start": 297,
        "line_end": 297,
        "snippet": "| `HttpUrl` | Valid URL |"
      },
      {
        "id": "blocker:references/type-narrowing.md:270:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/type-narrowing.md",
        "line_start": 270,
        "line_end": 270,
        "snippet": "5. **Avoid hasattr** - Type checkers struggle with it"
      },
      {
        "id": "external_commands:scripts/check-types.sh:87:shell-command-substitution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Shell command substitution",
        "file": "scripts/check-types.sh",
        "line_start": 87,
        "line_end": 87,
        "snippet": "TEMP_CONFIG=$(mktemp)"
      },
      {
        "id": "external_commands:scripts/check-types.sh:1:unix-shell-invocation",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Unix shell invocation",
        "file": "scripts/check-types.sh",
        "line_start": 1,
        "line_end": 1,
        "snippet": "#!/bin/bash"
      },
      {
        "id": "filesystem:scripts/check-types.sh:54:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "scripts/check-types.sh",
        "line_start": 54,
        "line_end": 54,
        "snippet": "if ! command -v mypy &> /dev/null; then"
      },
      {
        "id": "filesystem:scripts/check-types.sh:79:standard-device-file-access",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Standard device file access",
        "file": "scripts/check-types.sh",
        "line_start": 79,
        "line_end": 79,
        "snippet": "if ! command -v pyright &> /dev/null; then"
      },
      {
        "id": "filesystem:scripts/check-types.sh:87:temp-file-creation",
        "category": "filesystem",
        "severity": "low",
        "pattern": "Temp file creation",
        "file": "scripts/check-types.sh",
        "line_start": 87,
        "line_end": 87,
        "snippet": "TEMP_CONFIG=$(mktemp)"
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 16,
        "line_end": 30,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 30,
        "line_end": 34,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 49,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 49,
        "line_end": 53,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 64,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 68,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 86,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 86,
        "line_end": 90,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 90,
        "line_end": 105,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 105,
        "line_end": 109,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 109,
        "line_end": 124,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 124,
        "line_end": 128,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 143,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 143,
        "line_end": 147,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 147,
        "line_end": 157,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 161,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 161,
        "line_end": 172,
        "snippet": "```python"
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 172,
        "line_end": 178,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 178,
        "line_end": 179,
        "snippet": "| `X \\| None` | Optional value |"
      },
      {
        "id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 179,
        "line_end": 180,
        "snippet": "| `list[T]` | Homogeneous list |"
      },
      {
        "id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 180,
        "line_end": 181,
        "snippet": "| `dict[K, V]` | Dictionary |"
      },
      {
        "id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 181,
        "line_end": 182,
        "snippet": "| `Callable[[Args], Ret]` | Function type |"
      },
      {
        "id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 182,
        "line_end": 183,
        "snippet": "| `TypeVar(\"T\")` | Generic parameter |"
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 183,
        "line_end": 184,
        "snippet": "| `Protocol` | Structural typing |"
      },
      {
        "id": "external_commands:SKILL.md:184:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 184,
        "line_end": 185,
        "snippet": "| `TypedDict` | Dict with fixed keys |"
      },
      {
        "id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 185,
        "line_end": 186,
        "snippet": "| `Literal[\"a\", \"b\"]` | Specific values only |"
      },
      {
        "id": "external_commands:SKILL.md:186:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 186,
        "line_end": 190,
        "snippet": "| `Final` | Cannot be reassigned |"
      },
      {
        "id": "external_commands:SKILL.md:190:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 190,
        "line_end": 201,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 201,
        "line_end": 205,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 205,
        "line_end": 206,
        "snippet": "- `./references/generics-advanced.md` - TypeVar, ParamSpec, TypeVarTuple"
      },
      {
        "id": "external_commands:SKILL.md:206:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 206,
        "line_end": 207,
        "snippet": "- `./references/protocols-patterns.md` - Structural typing, runtime protocols"
      },
      {
        "id": "external_commands:SKILL.md:207:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 207,
        "line_end": 208,
        "snippet": "- `./references/type-narrowing.md` - Guards, isinstance, assert"
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 208,
        "line_end": 209,
        "snippet": "- `./references/mypy-config.md` - mypy/pyright configuration"
      },
      {
        "id": "external_commands:SKILL.md:209:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 209,
        "line_end": 210,
        "snippet": "- `./references/runtime-validation.md` - Pydantic v2, typeguard, beartype"
      },
      {
        "id": "external_commands:SKILL.md:210:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 210,
        "line_end": 214,
        "snippet": "- `./references/overloads.md` - @overload decorator patterns"
      },
      {
        "id": "external_commands:SKILL.md:214:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 214,
        "line_end": 218,
        "snippet": "- `./scripts/check-types.sh` - Run type checkers with common options"
      },
      {
        "id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 218,
        "line_end": 227,
        "snippet": "- `./assets/pyproject-typing.toml` - Recommended mypy/pyright config"
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 227,
        "line_end": 230,
        "snippet": "- `python-pytest-patterns` - Type-safe fixtures and mocking"
      },
      {
        "id": "external_commands:SKILL.md:230:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 230,
        "line_end": 231,
        "snippet": "- `python-async-patterns` - Async type annotations"
      },
      {
        "id": "external_commands:SKILL.md:231:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 231,
        "line_end": 232,
        "snippet": "- `python-fastapi-patterns` - Pydantic models and validation"
      },
      {
        "id": "network:SKILL.md:62:fetch-api-call",
        "category": "network",
        "severity": "low",
        "pattern": "Fetch API call",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "def fetch(url: str, timeout: float | None = None) -> bytes:"
      }
    ],
    "finding_verdicts": [
      {
        "id": "network:assets/pyproject-typing.toml:56:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The requests entry is a type-stub package name in a recommended development dependency list. It does not perform network access or collect data."
      },
      {
        "id": "sensitive:references/generics-advanced.md:102:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The words key and value are generic type parameter examples in a Pair class. They are not certificate, private key, or secret material handling."
      },
      {
        "id": "sensitive:references/generics-advanced.md:106:certificate-key-files",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The words key and value are generic type parameter examples in a Pair class. They are not certificate, private key, or secret material handling."
      },
      {
        "id": "blocker:references/generics-advanced.md:266:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/generics-advanced.md:267:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "network:references/mypy-config.md:33:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The requests references are mypy module names for missing-import configuration and type stubs. They do not import or call an HTTP library at runtime."
      },
      {
        "id": "network:references/mypy-config.md:53:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The requests references are mypy module names for missing-import configuration and type stubs. They do not import or call an HTTP library at runtime."
      },
      {
        "id": "network:references/mypy-config.md:246:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The GitHub URL points to the official pre-commit mirror for mypy in a sample CI configuration. It is user-facing setup documentation, not hidden network activity."
      },
      {
        "id": "network:references/overloads.md:42:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:45:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:48:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:50:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:61:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:62:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The fetch functions are overload examples used to teach return-type selection. They are static documentation snippets, not skill runtime network behavior."
      },
      {
        "id": "network:references/overloads.md:51:python-http-libraries",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "requests.get appears inside a documentation example explaining overloaded return types. The skill does not execute this example or exfiltrate data."
      },
      {
        "id": "network:references/overloads.md:61:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The URL is api.example.com inside an overload tutorial example. It is illustrative documentation, not an active endpoint used by the skill."
      },
      {
        "id": "network:references/overloads.md:62:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The URL is api.example.com inside an overload tutorial example. It is illustrative documentation, not an active endpoint used by the skill."
      },
      {
        "id": "blocker:references/protocols-patterns.md:44:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/protocols-patterns.md:286:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "scripts:references/runtime-validation.md:219:dynamic-import-expression",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The flagged block is a normal static Python import from pydantic in a runtime validation guide. There is no dynamic import expression or user-controlled module loading."
      },
      {
        "id": "blocker:references/runtime-validation.md:32:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:60:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:64:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:80:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:83:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:150:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:153:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:296:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/runtime-validation.md:297:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "blocker:references/type-narrowing.md:270:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The flagged text is ordinary typing tutorial content, such as example IDs, validation comments, or best-practice prose. It does not enumerate the system or gather host information."
      },
      {
        "id": "external_commands:scripts/check-types.sh:87:shell-command-substitution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The command substitution only captures mktemp output for a temporary pyright config path. It does not execute user-controlled input or fetch remote content."
      },
      {
        "id": "external_commands:scripts/check-types.sh:1:unix-shell-invocation",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "The shell script is a local helper for running mypy and pyright, not a persistence or system-control script. It uses fixed checker commands and quotes the user target when invoking them."
      },
      {
        "id": "filesystem:scripts/check-types.sh:54:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The /dev/null redirection is used with command -v to test whether mypy or pyright is installed. This is standard shell output suppression, not sensitive file access."
      },
      {
        "id": "filesystem:scripts/check-types.sh:79:standard-device-file-access",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The /dev/null redirection is used with command -v to test whether mypy or pyright is installed. This is standard shell output suppression, not sensitive file access."
      },
      {
        "id": "filesystem:scripts/check-types.sh:87:temp-file-creation",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "mktemp is used for a short-lived pyright strict-mode configuration file and is removed after the checker runs. This is normal local filesystem use for a development helper."
      },
      {
        "id": "external_commands:SKILL.md:16:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:49:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:86:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:109:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:143:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:180:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:181:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:182:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:183:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:184:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:185:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:186:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:190:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:201:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:205:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:206:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:207:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:209:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:210:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:214:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:218:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:230:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "external_commands:SKILL.md:231:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The flagged text is Markdown code fencing, inline code, or resource lists in documentation. It is not Ruby backtick execution and does not run commands by itself."
      },
      {
        "id": "network:SKILL.md:62:fetch-api-call",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The fetch function is a type-hint example with pass as the body. It demonstrates optional and union syntax and performs no network request."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 9,
    "total_lines": 2263,
    "audit_model": "claude",
    "audited_at": "2026-07-09T01:12:44.122Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Add Python Type Safety Patterns",
    "value_statement": "Python type annotations can be hard to apply consistently across real projects. This skill gives Claude, Codex, and Claude Code practical patterns for safer typed Python code.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Python typing",
      "type hints",
      "mypy",
      "pyright",
      "Protocol",
      "TypedDict",
      "Pydantic validation"
    ],
    "actual_capabilities": [
      "Shows modern Python 3.10+ type annotation patterns for functions, collections, unions, and optional values.",
      "Explains TypeVar, Generic, ParamSpec, TypeVarTuple, Self, and variance patterns.",
      "Provides Protocol and structural typing examples for flexible interfaces.",
      "Demonstrates overload patterns with Literal, optional parameters, generics, and async functions.",
      "Includes mypy and pyright configuration examples for strict type checking.",
      "Includes runtime validation examples with Pydantic, typeguard, and beartype."
    ],
    "limitations": [
      "It is a reference skill, not an automatic type migration tool.",
      "Some examples require Python 3.11 or newer features.",
      "It does not guarantee that project-specific third-party libraries have complete type stubs.",
      "The included shell script depends on locally installed mypy or pyright."
    ],
    "use_cases": [
      {
        "title": "Annotate new Python services",
        "description": "Use the reference patterns to add clear function signatures, collection types, and strict checker settings before code grows complex.",
        "target_user": "Backend engineers"
      },
      {
        "title": "Modernize legacy type hints",
        "description": "Apply unions, TypedDict, Protocol, and TypeGuard patterns to make existing Python code easier to check and maintain.",
        "target_user": "Maintainers of Python applications"
      },
      {
        "title": "Teach practical Python typing",
        "description": "Use the examples as structured explanations for teams learning mypy, pyright, generics, overloads, and runtime validation.",
        "target_user": "Technical leads and mentors"
      }
    ],
    "prompt_templates": [
      {
        "title": "Add basic annotations",
        "scenario": "Beginner task for a small function or module.",
        "prompt": "Add Python type hints to this module using modern Python 3.10+ syntax. Keep the changes simple and explain any uncertain types."
      },
      {
        "title": "Choose safer collection types",
        "scenario": "Intermediate task for API boundaries or shared helpers.",
        "prompt": "Review these function signatures and suggest better collection types, such as Sequence, Mapping, Iterable, TypedDict, or Protocol."
      },
      {
        "title": "Configure strict type checking",
        "scenario": "Project setup with mypy or pyright.",
        "prompt": "Create a practical mypy and pyright configuration for this Python project. Explain which strict settings should be enabled first."
      },
      {
        "title": "Design advanced typed APIs",
        "scenario": "Advanced work on libraries, decorators, or polymorphic APIs.",
        "prompt": "Use TypeVar, ParamSpec, Protocol, overload, and runtime validation where appropriate to make this API type-safe without overcomplicating it."
      }
    ],
    "output_examples": [
      {
        "input": "A function accepts either text or bytes and should return the same kind of value.",
        "output": "The skill would recommend overload signatures for each input type, followed by one implementation that handles all accepted cases."
      },
      {
        "input": "A project wants stricter type checking but has untyped tests and third-party packages.",
        "output": "The skill would suggest strict defaults, targeted test overrides, missing-import settings, and separate mypy or pyright configuration examples."
      },
      {
        "input": "A service needs validation for request dictionaries at runtime.",
        "output": "The skill would suggest TypedDict for static shape and Pydantic TypeAdapter or BaseModel patterns for runtime validation."
      }
    ],
    "best_practices": [
      "Start with function boundaries, public models, and configuration before annotating every internal variable.",
      "Use Protocol for behavior-based interfaces and TypedDict for dictionaries with known keys.",
      "Run mypy or pyright regularly so type annotations stay accurate as code changes."
    ],
    "anti_patterns": [
      "Do not use Any to silence errors unless the value truly has an unknown type boundary.",
      "Do not add overloads when a simple union or generic type explains the API clearly.",
      "Do not rely on runtime validation alone when static type checks can catch issues earlier."
    ],
    "faq": [
      {
        "question": "Does this skill write type hints automatically?",
        "answer": "It provides patterns and guidance that Claude, Codex, or Claude Code can apply when editing Python code."
      },
      {
        "question": "Which Python versions are supported?",
        "answer": "Most examples target Python 3.10 or newer. Some patterns, such as Self and TypeVarTuple, need Python 3.11 or newer."
      },
      {
        "question": "Does it support both mypy and pyright?",
        "answer": "Yes. It includes configuration examples and command guidance for both type checkers."
      },
      {
        "question": "Can it help with Pydantic?",
        "answer": "Yes. It includes Pydantic v2 examples for models, validators, function arguments, and TypeAdapter validation."
      },
      {
        "question": "Is this useful for existing projects?",
        "answer": "Yes. The gradual typing guidance helps teams add stricter checks in phases without blocking all legacy code at once."
      },
      {
        "question": "Does it execute network requests?",
        "answer": "No. Network-looking snippets are documentation examples. The included helper script only runs local type checkers."
      }
    ]
  },
  "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