Skip to content

aiskillstore/marketplace / skills/0xbigboss/zig-best-practices

zig-best-practices

Verified

Use when reading or writing Zig files (.zig, build.zig, build.zig.zon).

FileKindSize
C-INTEROP.mdmarkdown2.0 KB
DEBUGGING.mdmarkdown1.6 KB
GENERICS.mdmarkdown1.7 KB
SKILL.mdskill md3.3 KB
skill-report.jsonconfig31.9 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-06T14:17:41.589Z",
    "slug": "0xbigboss-zig-best-practices",
    "source_url": "https://github.com/0xBigBoss/claude-code/tree/main/.claude/skills/zig-best-practices",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "b44bbabb0c6618c79da83fcd95c427ca54c66bafd740367b91e50feaf0c8406e",
    "tree_hash": "d63cca4a0683a97103f9b799fa05651d4188e9ff3505763cf0a5d0f4f465806d",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "zig-best-practices",
    "description": "Apply practical Zig patterns for type design, explicit errors, allocator ownership, generics, C interop, and memory debugging.",
    "summary": "Review or write Zig code with established idioms and focused tooling guidance.",
    "icon": "📦",
    "version": "1.0.1",
    "author": "0xBigBoss",
    "license": "MIT",
    "tags": [
      "zig",
      "best-practices",
      "systems-programming",
      "memory-management",
      "c-interop"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "scripts",
      "external_commands",
      "network"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "AI review found the static alerts to be false positives from Zig examples, Markdown code fences, and passive documentation links. No prompt injection, data exfiltration intent, or malicious execution path was found in the reviewed files.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "C-INTEROP.md",
            "line_start": 46,
            "line_end": 46
          },
          {
            "file": "DEBUGGING.md",
            "line_start": 14,
            "line_end": 14
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 20
          },
          {
            "file": "SKILL.md",
            "line_start": 20,
            "line_end": 22
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 29
          },
          {
            "file": "SKILL.md",
            "line_start": 29,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 35
          },
          {
            "file": "SKILL.md",
            "line_start": 35,
            "line_end": 40
          },
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 45
          },
          {
            "file": "SKILL.md",
            "line_start": 45,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 46,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 50
          },
          {
            "file": "SKILL.md",
            "line_start": 50,
            "line_end": 57
          },
          {
            "file": "SKILL.md",
            "line_start": 57,
            "line_end": 61
          },
          {
            "file": "SKILL.md",
            "line_start": 61,
            "line_end": 61
          },
          {
            "file": "SKILL.md",
            "line_start": 62,
            "line_end": 62
          },
          {
            "file": "SKILL.md",
            "line_start": 63,
            "line_end": 63
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 80
          },
          {
            "file": "SKILL.md",
            "line_start": 80,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 83
          },
          {
            "file": "SKILL.md",
            "line_start": 83,
            "line_end": 86
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 90,
            "line_end": 90
          },
          {
            "file": "SKILL.md",
            "line_start": 91,
            "line_end": 91
          },
          {
            "file": "SKILL.md",
            "line_start": 92,
            "line_end": 92
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "scripts:C-INTEROP.md:46:dynamic-import-expression",
        "category": "scripts",
        "severity": "medium",
        "pattern": "Dynamic import() expression",
        "file": "C-INTEROP.md",
        "line_start": 46,
        "line_end": 46,
        "snippet": "const win = @import(\"std\").os.windows;"
      },
      {
        "id": "blocker:C-INTEROP.md:21:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "C-INTEROP.md",
        "line_start": 21,
        "line_end": 21,
        "snippet": "pub fn main() void {"
      },
      {
        "id": "scripts:DEBUGGING.md:14:dynamic-import-expression",
        "category": "scripts",
        "severity": "medium",
        "pattern": "Dynamic import() expression",
        "file": "DEBUGGING.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "const std = @import(\"std\");"
      },
      {
        "id": "blocker:DEBUGGING.md:16:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "DEBUGGING.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "pub fn main() !void {"
      },
      {
        "id": "blocker:GENERICS.md:30:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "GENERICS.md",
        "line_start": 30,
        "line_end": 30,
        "snippet": "pub fn enqueue(self: *Self, value: Child) !void {"
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 20,
        "snippet": "```zig"
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 20,
        "line_end": 22,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 23,
        "snippet": "**Explicit error sets** — documents exactly what can fail; `anyerror` hides failure modes:"
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 26,
        "snippet": "```zig"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 29,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 29,
        "line_end": 32,
        "snippet": "```zig"
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 35,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 35,
        "line_end": 40,
        "snippet": "```zig"
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 40,
        "line_end": 45,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 45,
        "line_end": 46,
        "snippet": "- Place `defer resource.deinit()` immediately after acquisition — keeps cleanup co-located with crea"
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 46,
        "line_end": 46,
        "snippet": "- Use `errdefer` for cleanup on error paths; `defer` for unconditional cleanup."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 50,
        "snippet": "- Use `std.testing.allocator` in tests — reports leaks with stack traces."
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 50,
        "line_end": 57,
        "snippet": "```zig"
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 57,
        "line_end": 61,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:61:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 61,
        "line_end": 61,
        "snippet": "- Prefer `const` over `var`; prefer slices over raw pointers."
      },
      {
        "id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "- Prefer `comptime T: type` over `anytype`; explicit types produce clearer errors. Use `anytype` onl"
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 63,
        "line_end": 63,
        "snippet": "- Exhaustive `switch`: include an `else` returning an error or `unreachable` for truly impossible ca"
      },
      {
        "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": 64,
        "snippet": "- Use `std.log.scoped(.module_name)` for namespaced logging; define a module-level `const log` const"
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 80,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 80,
        "line_end": 82,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 83,
        "snippet": "**ziglint** — static analysis with `.ziglint.zon` config:"
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 83,
        "line_end": 86,
        "snippet": "```bash"
      },
      {
        "id": "network:SKILL.md:90:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 90,
        "line_end": 90,
        "snippet": "- Language Reference: https://ziglang.org/documentation/0.15.2/"
      },
      {
        "id": "network:SKILL.md:91:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 91,
        "line_end": 91,
        "snippet": "- Standard Library: https://ziglang.org/documentation/0.15.2/std/"
      },
      {
        "id": "network:SKILL.md:92:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 92,
        "line_end": 92,
        "snippet": "- Zig Guide: https://zig.guide/"
      },
      {
        "id": "blocker:SKILL.md:12:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 12,
        "line_end": 12,
        "snippet": "**Tagged unions for mutually exclusive states** — prevents invalid combinations that a struct with m"
      },
      {
        "id": "blocker:SKILL.md:34:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "**Comptime validation** — catch invalid configurations at compile time, not runtime:"
      }
    ],
    "finding_verdicts": [
      {
        "id": "scripts:C-INTEROP.md:46:dynamic-import-expression",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This is Zig standard library import syntax inside documentation about Windows API interop. It does not dynamically load user-controlled code or execute scripts."
      },
      {
        "id": "blocker:C-INTEROP.md:21:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The snippet is a Zig example entry point for raylib drawing. It contains no host enumeration, credential access, or system discovery logic."
      },
      {
        "id": "scripts:DEBUGGING.md:14:dynamic-import-expression",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "This is a Zig standard library import in a memory debugging example. No dynamic module loading from untrusted input is present."
      },
      {
        "id": "blocker:DEBUGGING.md:16:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The function is a standalone example for allocator leak detection. It does not collect system information or inspect the runtime environment."
      },
      {
        "id": "blocker:GENERICS.md:30:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The method allocates a queue node in an example generic container. There is no reconnaissance behavior or host inspection."
      },
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown Zig code fence, not Ruby backtick execution. It is documentation content and has no execution path."
      },
      {
        "id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code fence terminator, not shell evaluation. It cannot execute commands as written."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for the Zig term anyerror. It is not shell backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown Zig code fence, not Ruby backtick execution. It is documentation content and has no execution path."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code fence terminator, not shell evaluation. It cannot execute commands as written."
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown Zig code fence, not Ruby backtick execution. It is documentation content and has no execution path."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code fence terminator, not shell evaluation. It cannot execute commands as written."
      },
      {
        "id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown Zig code fence, not Ruby backtick execution. It is documentation content and has no execution path."
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code fence terminator, not shell evaluation. It cannot execute commands as written."
      },
      {
        "id": "external_commands:SKILL.md:45:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for a Zig defer statement. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for Zig defer keywords. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for std.testing.allocator. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown Zig code fence, not Ruby backtick execution. It is documentation content and has no execution path."
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The matched text is a Markdown code fence terminator, not shell evaluation. It cannot execute commands as written."
      },
      {
        "id": "external_commands:SKILL.md:61:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for Zig const and var terms. It is not shell backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:62:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for Zig type terms. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:63:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for Zig switch handling. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "This line uses inline Markdown code formatting for Zig logging names. It is not shell backtick execution or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a Markdown bash code fence introducing optional zigdoc examples. The skill text does not execute those commands itself."
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.9,
        "reason": "The matched text is a Markdown code fence terminator after optional tooling examples. It is not Ruby or shell command execution."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.91,
        "reason": "This line uses inline Markdown code formatting for a ziglint config filename. It is not shell backtick execution."
      },
      {
        "id": "external_commands:SKILL.md:83:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.88,
        "reason": "This is a Markdown bash code fence introducing optional ziglint examples. No unsanitized command execution exists in the skill file."
      },
      {
        "id": "network:SKILL.md:90:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The URL points to official Zig language reference documentation. It is a passive reference link, not a network request or data exfiltration path."
      },
      {
        "id": "network:SKILL.md:91:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The URL points to official Zig standard library documentation. It is a passive reference link, not a network request or data exfiltration path."
      },
      {
        "id": "network:SKILL.md:92:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.93,
        "reason": "The URL points to Zig Guide documentation. It is a passive reference link, not a network request or data exfiltration path."
      },
      {
        "id": "blocker:SKILL.md:12:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The line is a heading about tagged unions for state modeling. It contains no reconnaissance request or host inspection behavior."
      },
      {
        "id": "blocker:SKILL.md:34:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The line is a heading about compile-time validation in Zig. It contains no reconnaissance request or host inspection behavior."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 4,
    "total_lines": 318,
    "audit_model": "codex",
    "audited_at": "2026-07-06T14:17:41.589Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Apply Zig Best Practices",
    "value_statement": "Zig projects need consistent patterns for errors, allocators, generics, C interop, and debugging. This skill guides Claude, Codex, and Claude Code with concise Zig idioms and tool references.",
    "seo_keywords": [
      "Zig best practices",
      "Zig programming",
      "Claude",
      "Codex",
      "Claude Code",
      "Zig memory management",
      "Zig C interop",
      "Zig generics",
      "Zig debugging",
      "Zig linting"
    ],
    "actual_capabilities": [
      "Explains Zig type patterns such as tagged unions, explicit error sets, and distinct domain IDs.",
      "Guides allocator ownership, defer, errdefer, arenas, and testing allocator usage.",
      "Provides patterns for generic containers using comptime type parameters.",
      "Shows C interoperability basics for imports, extern calls, callbacks, and C type mapping.",
      "Covers memory debugging with GeneralPurposeAllocator and std.testing.allocator.",
      "Lists Zig tooling references for zigdoc, ziglint, and official documentation."
    ],
    "limitations": [
      "Does not install Zig, external libraries, or linting tools.",
      "Does not replace project-specific API documentation or version checks.",
      "Does not provide full production implementations for every pattern.",
      "Assumes the user can review generated Zig code before running it."
    ],
    "use_cases": [
      {
        "title": "Review Zig modules",
        "description": "Check error sets, allocators, and cleanup patterns before merging Zig changes.",
        "target_user": "Systems engineer"
      },
      {
        "title": "Add C library bindings",
        "description": "Plan imports, extern calls, callbacks, and type mappings for C libraries.",
        "target_user": "Game developer"
      },
      {
        "title": "Debug memory leaks",
        "description": "Use GPA and testing allocator patterns to find missed cleanup paths.",
        "target_user": "Library maintainer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Review a Zig file",
        "scenario": "Beginner review",
        "prompt": "Review this Zig file for const usage, explicit errors, allocator flow, and cleanup. Explain each recommendation briefly."
      },
      {
        "title": "Improve allocator handling",
        "scenario": "Intermediate cleanup review",
        "prompt": "Inspect this Zig module for allocator ownership, defer placement, errdefer use, and leak risks. Suggest practical changes."
      },
      {
        "title": "Design a generic container",
        "scenario": "Advanced API planning",
        "prompt": "Help design a Zig generic container using comptime type parameters. Include API shape, ownership rules, error sets, and tests to add."
      },
      {
        "title": "Plan C interop safely",
        "scenario": "Advanced integration review",
        "prompt": "Plan Zig interop for this C library. Cover imports, linking, callbacks, pointer casts, error boundaries, and debugging checks."
      }
    ],
    "output_examples": [
      {
        "input": "Review memory handling in a Zig parser.",
        "output": [
          "Allocator ownership should stay with the parser context.",
          "Place cleanup immediately after each allocation path.",
          "Use errdefer for partial initialization failures.",
          "Add a leak test with the testing allocator."
        ]
      },
      {
        "input": "Plan C interop for a small graphics library.",
        "output": [
          "Import the C headers and configure include paths in the build file.",
          "Keep callbacks C-compatible and convert opaque pointers at the boundary.",
          "Map null values and sentinel strings explicitly."
        ]
      },
      {
        "input": "Improve a generic queue API.",
        "output": "The review recommends explicit child type parameters, a private node type, allocator injection, and ownership tests for queue operations."
      }
    ],
    "best_practices": [
      "Ask the assistant to justify Zig idioms with specific failure modes or maintenance benefits.",
      "Review generated examples against your Zig compiler version and project style.",
      "Run tests and leak checks before accepting allocator or C interop changes."
    ],
    "anti_patterns": [
      "Do not accept anytype when a comptime type parameter would make errors clearer.",
      "Do not hide cleanup away from allocation sites.",
      "Do not copy C pointer casts without checking alignment, sentinel rules, and ownership."
    ],
    "faq": [
      {
        "question": "Which Zig files does this skill support?",
        "answer": "It is intended for .zig files, build.zig files, and build.zig.zon files."
      },
      {
        "question": "Can it write complete Zig modules?",
        "answer": "It can help draft modules, but the user should compile, test, and review the result."
      },
      {
        "question": "Does it run Zig tools automatically?",
        "answer": "No. It provides guidance about tools such as zigdoc and ziglint."
      },
      {
        "question": "Does it cover C interoperability?",
        "answer": "Yes. It includes patterns for C imports, extern functions, callbacks, and C type mapping."
      },
      {
        "question": "Can it find memory leaks?",
        "answer": "It suggests GeneralPurposeAllocator and std.testing.allocator patterns for finding leaks during development and tests."
      },
      {
        "question": "Is it tied to one Zig version?",
        "answer": "The references mention Zig 0.15.2, but users should verify details against their installed compiler."
      }
    ]
  },
  "file_structure": [
    {
      "name": "C-INTEROP.md",
      "type": "file",
      "path": "C-INTEROP.md",
      "lines": 90
    },
    {
      "name": "DEBUGGING.md",
      "type": "file",
      "path": "DEBUGGING.md",
      "lines": 71
    },
    {
      "name": "GENERICS.md",
      "type": "file",
      "path": "GENERICS.md",
      "lines": 64
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 93
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall