Agent skill

Nginx C Module Debug

by pproenca in pproenca/dot-skills

nginx C module debugging guidelines based on the official nginx development guide.

MITAuto-check passedDevOps & Cloud

Install Nginx C Module Debug

skills CLI
$ npx skills add pproenca/dot-skills --skill nginx-c-module-debug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pproenca/dot-skills nginx-c-module-debug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.experimental/nginx-c-module-debug .claude/skills/nginx-c-module-debug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nginx-c-module-debug
GitHub stars
214
Token cost
~2.1k tokens
SKILL.md length
659 words
Files
49 (incl. references, assets)
Skills in repo
182
Repo updated
First seen
Licence
MIT

At a glance

nginx C module debugging guidelines based on the official nginx development guide.

  • Works in 8 steps: Crash Diagnosis & Signals (CRITICAL) → Memory Bug Detection (CRITICAL) → GDB & Core Dump Analysis (HIGH) → …
  • Tasks involving segfault analysis
  • SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Nginx C Module Debug is an agent skill from pproenca/dot-skills. nginx C module debugging guidelines based on the official nginx development guide. This skill should be used when debugging nginx C module crashes, memory bugs, request flow issues, or production problems. Triggers on tasks involving segfault analysis, coredump debugging, GDB inspection, memory leak detection, request phase tracing, AddressSanitizer setup, or nginx module troubleshooting.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 51 other files, including reference files and assets (for example `assets/templates/_template.md`, `metadata.json` and `references/_sections.md`).

It sits in DevOps & Cloud, covering Cloud networking and Debugging. It works with NGINX. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.

When your agent uses it

  • Tasks involving segfault analysis
  • Coredump debugging
  • Memory leak detection
  • Request phase tracing

Example prompts

  • “/nginx-c-module-debug”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Crash Diagnosis & Signals (CRITICAL)
  2. Memory Bug Detection (CRITICAL)
  3. GDB & Core Dump Analysis (HIGH)
  4. Request Flow Tracing (HIGH)
  5. Debug Logging Patterns (MEDIUM-HIGH)
  6. State & Lifecycle Debugging (MEDIUM)
  7. Dynamic Tracing Tools (MEDIUM)
  8. Build & Sanitizer Configuration (LOW-MEDIUM)

What it can do on your machine

Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nginx C Module Debug loads about 2.1k tokens when it runs, and up to ~45k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 659 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~45k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 659 words, ~2,145 tokens.

Download SKILL.mdSave it as .claude/skills/nginx-c-module-debug/SKILL.md (or your agent's skills folder). This skill also uses 48 other files; get the full folder from GitHub.
name
nginx-c-module-debug
description
nginx C module debugging guidelines based on the official nginx development guide. This skill should be used when debugging nginx C module crashes, memory bugs, request flow issues, or production problems. Triggers on tasks involving segfault analysis, coredump debugging, GDB inspection, memory leak detection, request phase tracing, AddressSanitizer setup, or nginx module troubleshooting.

nginx.org C Module Debugging Best Practices

Comprehensive debugging guide for nginx C modules, derived from the official nginx development documentation and production debugging experience. Contains 45 rules across 8 categories, prioritized by impact to guide systematic diagnosis of crashes, memory bugs, and behavioral issues in nginx modules.

Companion skills: This skill complements nginx-c-modules (correctness) and nginx-c-module-perf-reliability (performance). This skill covers debugging and diagnosis.

When to Apply

Reference these guidelines when:

  • Diagnosing nginx worker crashes (segfaults, SIGABRT, SIGSEGV)
  • Finding memory bugs (use-after-free, leaks, pool corruption, buffer overruns)
  • Setting up GDB and core dump analysis for nginx
  • Tracing request flow through phases, subrequests, and filter chains
  • Instrumenting nginx modules with debug logging and dynamic tracing tools

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Crash Diagnosis & SignalsCRITICALcrash-
2Memory Bug DetectionCRITICALmemdbg-
3GDB & Core Dump AnalysisHIGHgdb-
4Request Flow TracingHIGHtrace-
5Debug Logging PatternsMEDIUM-HIGHdbglog-
6State & Lifecycle DebuggingMEDIUMstate-
7Dynamic Tracing ToolsMEDIUMprobe-
8Build & Sanitizer ConfigurationLOW-MEDIUMbuild-

Quick Reference

1. Crash Diagnosis & Signals (CRITICAL)
2. Memory Bug Detection (CRITICAL)
3. GDB & Core Dump Analysis (HIGH)
4. Request Flow Tracing (HIGH)
Show full SKILL.md (244 more words)Show less
5. Debug Logging Patterns (MEDIUM-HIGH)
6. State & Lifecycle Debugging (MEDIUM)
7. Dynamic Tracing Tools (MEDIUM)
8. Build & Sanitizer Configuration (LOW-MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

FileDescription
references/_sections.mdCategory definitions and ordering
assets/templates/_template.mdTemplate for new rules
metadata.jsonVersion and reference information

© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 48 other files (references, assets) in skills/.experimental/nginx-c-module-debug of pproenca/dot-skills.

  • SKILL.md
  • assets/templates/_template.md
  • metadata.json
  • references/_sections.md
  • references/build-asan-configure.md
  • references/build-debug-flags.md
  • references/build-debug-palloc.md
  • references/build-single-process.md
  • references/build-valgrind-suppressions.md
  • references/crash-double-free-finalize.md
  • references/crash-error-page-redirect.md
  • references/crash-null-deref-pattern.md
  • references/crash-segfault-signature.md
  • references/crash-stack-overflow.md
  • references/crash-worker-exit-log.md
  • references/dbglog-debug-connection.md
  • references/dbglog-debug-mask.md
  • references/dbglog-format-ngx-str.md
  • … and 31 more

Open the folder on GitHubat commit cf93c57

Compare with similar skills

Nginx C Module Debug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nginx C Module Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nginx C Module Debug this skillpproenca/dot-skills214—~2.1kAutomated safety check: PassMIT
Nginx To Higress Migrationhigress-group/higress9.5k—~3.9kAutomated safety check: PassApache-2.0
NGINX Ingress Controller Feature Checklistsnginx/kubernetes-ingress5.1k—~1.4kAutomated safety check: PassApache-2.0
NGINX Ingress Policy CRD Guidenginx/kubernetes-ingress5.1k—~2kAutomated safety check: PassApache-2.0
KubeSphere Gateway Managementkubesphere/kubesphere17k—~2.9kAutomated safety check: PassCustom licence
Wp Static Clonejdevalk/skills104—~2.6kAutomated safety check: PassMIT

Similar skills

  • Nginx To Higress Migration

    higress-group/higress

    Migrate from ingress-nginx to Higress in Kubernetes environments.

    9.5k GitHub stars~3.9k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • Gives step-by-step checklists for adding Ingress annotations, VirtualServer fields and Helm values to the NGINX Kubernetes Ingress Controller, with common gotchas.

    5.1k GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • NGINX Ingress Policy CRD Guide

    nginx/kubernetes-ingress

    Step-by-step checklist for adding a new Policy CRD type to the NGINX Ingress Controller, from the Go types and validation to config generation and templates.

    5.1k GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • KubeSphere Gateway Management

    kubesphere/kubesphere

    Installs, uninstalls, checks and troubleshoots the KubeSphere Gateway extension built on ingress-nginx, including gateways stuck in bad states and Helm or pod failures.

    17k GitHub stars~2.9k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Wp Static Clone

    jdevalk/skills

    Clones a live WordPress (or other CMS-driven) site into a static HTML site deployable on any static host (Cloudflare Pages, Netlify, Vercel, S3+CloudFront, plain Apache/nginx).

    104 GitHub stars~2.6k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check passed
  • Analyze production Node.js app container response times to find slow-rendering sites, cross-checking against nginx queuing delay to rule out false positives (a site only looks slow because the event…

    2k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from pproenca/dot-skills

All 182 skills in this repo
  • Audio Voice Recovery

    pproenca/dot-skills

    Audio forensics and voice recovery guidelines for CSI-level audio analysis.

    214 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Codemod React Pipeline

    pproenca/dot-skills

    Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.

    214 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dev Rfc

    pproenca/dot-skills

    Create well-structured RFCs and technical proposals for software projects.

    214 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Dx Harness

    pproenca/dot-skills

    Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.

    214 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Language Spec Author

    pproenca/dot-skills

    Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…

    214 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Python Pep Author

    pproenca/dot-skills

    Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…

    214 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Nginx C Module Debug

What does Nginx C Module Debug do?

nginx C module debugging guidelines based on the official nginx development guide. Nginx C Module Debug is an agent skill from pproenca/dot-skills. nginx C module debugging guidelines based on the official nginx development guide.

When should I use Nginx C Module Debug?

Nginx C Module Debug fits situations like: tasks involving segfault analysis; coredump debugging; memory leak detection; request phase tracing.

How do I install Nginx C Module Debug in Claude Code?

Run `npx skills add pproenca/dot-skills --skill nginx-c-module-debug -a claude-code`. Or copy the skill folder (skills/.experimental/nginx-c-module-debug in pproenca/dot-skills) into .claude/skills/nginx-c-module-debug in your project. Claude Code loads it when a task matches its description.

How do I install Nginx C Module Debug in Codex?

Run `npx skills add pproenca/dot-skills --skill nginx-c-module-debug -a codex`. Or copy the skill folder (skills/.experimental/nginx-c-module-debug in pproenca/dot-skills) into .agents/skills/nginx-c-module-debug in your project. Codex loads it when a task matches its description.

Can I use Nginx C Module Debug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill nginx-c-module-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nginx-c-module-debug, .gemini/skills/nginx-c-module-debug, .github/skills/nginx-c-module-debug and .opencode/skills/nginx-c-module-debug in your project.

What does Nginx C Module Debug need to run?

SKILL.md names no scripts, command-line tools or credentials: Nginx C Module Debug is instructions for the agent only.

Does Nginx C Module Debug access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nginx C Module Debug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nginx C Module Debug use?

Nginx C Module Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nginx C Module Debug use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 43k tokens, read only when the agent opens those files.

What are the alternatives to Nginx C Module Debug?

Skills that share tags, products or a category with Nginx C Module Debug: Nginx To Higress Migration (higress-group/higress, 9.5k stars), NGINX Ingress Controller Feature Checklists (nginx/kubernetes-ingress, 5.1k stars), NGINX Ingress Policy CRD Guide (nginx/kubernetes-ingress, 5.1k stars) and KubeSphere Gateway Management (kubesphere/kubesphere, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nginx C Module Debug?

pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 214 GitHub stars. The repository holds 182 skills in this directory. The repository was last updated on August 15, 2026.

Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.