Mole Bug Patterns
tw93/Mole
A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.
A skill your agent uses when the user is invoking the DOCA PCC Counters tool — the pcccounters.sh bash script under the DOCA tools directory — to arm and read the fixed firmware/hardware PCC…
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install NVIDIA/skills doca-pcc-counters --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/doca-pcc-counters .claude/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.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/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .claude/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-countersType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install NVIDIA/skills doca-pcc-counters --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/doca-pcc-counters .agents/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .agents/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install NVIDIA/skills doca-pcc-counters --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/doca-pcc-counters .cursor/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .cursor/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/NVIDIA/skills.git --path skills/doca-pcc-counters--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install NVIDIA/skills doca-pcc-counters --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/doca-pcc-counters .gemini/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .gemini/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install NVIDIA/skills doca-pcc-countersInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/doca-pcc-counters .github/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .github/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add NVIDIA/skills --skill doca-pcc-counters -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install NVIDIA/skills doca-pcc-counters --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/NVIDIA/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/doca-pcc-counters .opencode/skills/doca-pcc-counters && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "doca-pcc-counters" agent skill from https://github.com/NVIDIA/skills/tree/main/skills/doca-pcc-counters into .opencode/skills/doca-pcc-counters/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "doca-pcc-counters", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
doca-pcc-countersA skill your agent uses when the user is invoking the DOCA PCC Counters tool — the pcccounters.sh bash script under the DOCA tools directory — to arm and read the fixed firmware/hardware PCC…
Doca Pcc Counters is an agent skill from NVIDIA/skills, published by the product's own GitHub organization. Use this skill when the user is invoking the DOCA PCC Counters tool — the pcccounters.sh bash script under the DOCA tools directory — to arm and read the fixed firmware/hardware PCC (Programmable Congestion Control) diagnostic counters (CNP, RTT, WRED-drop, etc.) on a ConnectX / BlueField device via mst + the mlx5 debugfs diagcnt interface. The script takes two positional args — set | query and an mst device path — with no --help or subcommands. Trigger even without "pcccounters.sh" or "PCC counters": "how do I…
Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `BENCHMARK.md`, `CAPABILITIES.md` and `SKILLCARD.yaml`). Compatibility notes: Requires DOCA/MFT on Linux with a ConnectX-6 or newer or BlueField device, mst tools, mounted debugfs, and root access to the mlx5 diagcnt interface. The…
It sits in Development, covering Shell scripting. It works with Bash. The repository describes itself as: Agent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end. The licence is Apache-2.0.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 0e0d506. It shows what the files ask for, not the result of running them.
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.
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.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Requires DOCA/MFT on Linux with a ConnectX-6 or newer or BlueField device, mst tools, mounted debugfs, and root access to the mlx5 diag_cnt interface. The script reads fixed firmware and hardware diagnostics independently of custom PCC code. Its set operation changes which counters are collected, not congestion-control or forwarding behavior; treat later fleet tuning as a separate high-stakes action.
From compatibility in the SKILL.md frontmatter.
Doca Pcc Counters loads about 3k tokens when it runs. Until then it costs about 209 tokens; SKILL.md has 1,318 words of instructions outside code blocks.
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.
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.
The full file from NVIDIA/skills at commit 0e0d506, republished under its Apache-2.0 licence (© NVIDIA). 1,318 words, ~3,026 tokens.
.claude/skills/doca-pcc-counters/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.pcc_counters.sh)Where to start: This is a tool skill for invoking
pcc_counters.sh — a small bash script that arms and reads the
device's fixed set of firmware / hardware PCC diagnostic
counters (CNP count, RTT-perf, WRED-drop, RTT-gen, handled
events) through the mlx5 debugfs diag_cnt interface. Open
TASKS.md and start at ## run for
the canonical set-then-query sequence, or
## debug when the user reports
"ERROR: Bad Device", "counter stuck at zero", or "the
dump is empty". Open CAPABILITIES.md when
the question is which counters the script reports and how it
reaches them. If the user has not installed DOCA / MFT yet,
route to doca-setup first.
This skill is the firmware / HW PCC counter readout surface.
It is NOT the host-side control library that loads custom
congestion-control kernels onto the DPA (that is
doca-pcc) and it is NOT the
firmware PCC algorithm configuration (that path is firmware
configuration, routed via
doca-public-knowledge-map).
The counters this script reads are device / firmware
diagnostic counters that exist regardless of whether a custom
doca-pcc DPA kernel is running — do not condition them on a
custom kernel being loaded.
The CLASSES of pcc_counters.sh questions this skill is built
to answer, each with one worked example. The class is the
load-bearing piece; the worked example is one instance.
/dev/mst/mt41692_pciconf0".
Answered by the fixed counter set in
CAPABILITIES.md ## Capabilities and modesset-then-query invocation in
TASKS.md ## run.set | query + an mst device path) in
TASKS.md ## run.ERROR: Bad Device — what's wrong?"
— worked example: "my device path is not matching".
Answered by the device-resolution layer in
CAPABILITIES.md ## Error taxonomy
PCC_CNP_COUNT reads 0 after query". Answered
by the arm-before-read rule and the layered diagnosis in
TASKS.md ## debug +
CAPABILITIES.md ## Error taxonomy.pcc_counters.sh present and where does the
install put it". Answered by the install overlay in
CAPABILITIES.md ## Version compatibility,
which redirects to the canonical
doca-version rules.This skill serves operators, developers, and AI agents who need to read a ConnectX / BlueField device's firmware PCC diagnostic counters to reason about congestion-control behaviour (CNP generation, RTT requests/responses, WRED drops) on a port. Concretely:
doca-pcc algorithm's
effect with the device-level PCC diagnostic counters
(the script reads the firmware counters; the custom
algorithm itself is a separate surface owned by
doca-pcc).It is not for users debugging the script's bash itself,
not the place to learn how to write a custom PCC
algorithm — that audience belongs in
doca-pcc — and not the
place for users who want to configure the factory firmware PCC
algorithm (route via
doca-public-knowledge-map).
pcc_counters.sh is shipped as a plain bash script
installed under the DOCA tools directory (per install_data in
tools/pcc_counters/meson.build), not a compiled binary and
not a library you link against. The skill uses the bundle's
kind: tool three-file shape (SKILL.md + CAPABILITIES.md
TASKS.md) so the agent's task-verb contract
(configure / build / modify / run / test / debug) is uniform
across the bundle.Load this skill when the user is — or the agent needs to — arm and read the device PCC diagnostic counters on a host or BlueField Arm with the mst tools available and debugfs mounted. Concretely:
set on a target mst
device.query and quoting the
named counter lines verbatim.Do not load this skill for general DOCA orientation,
custom-PCC algorithm design, the host-side doca-pcc library
API, the factory firmware PCC algorithm, or DOCA / MFT install.
For those, route to
doca-public-knowledge-map,
doca-pcc, or
doca-setup.
This is a thin loader. Substantive material lives in two companion files:
CAPABILITIES.md — what pcc_counters.sh does: the exact
two-operation surface (set arms the device's diagnostic
counters by writing counter IDs + params to debugfs;
query reads the diag_cnt/dump and prints the named
counters), the FIXED firmware / HW counter set it knows
(PCC_CNP_COUNT, the MAD_RTT_PERF_CONT_*, the
*_EVENT_WRED_DROP family, HANDLED_*_EVENTS, the
DROP_RTT_PORT*/RTT_GEN_PORT* families), how it resolves
an mst device to a PCI address (mst status -v + lspci)
and reaches /sys/kernel/debug/mlx5/<pci>/diag_cnt/, the
install-availability overlay that redirects to
doca-version, the layered
error taxonomy (script-not-present / bad-device /
not-armed-before-query / debugfs-or-permission /
counter-stuck-at-zero / cross-cutting), and the safety
policy that flags set as a privileged debugfs write and
any CC tuning decision derived from a reading as
high-stakes.TASKS.md — step-by-step workflows for the in-scope task
verbs: configure (route to install + confirm mst /
debugfs / sudo), build (route to install; nothing to
compile — it is a script), modify (refuse — do not patch
the shipped script), run (the set-then-query
sequence), test (confirm the dump contains the named
counters with finite values), debug (the layered
diagnosis ladder), plus a Deferred task verbs block and a
Command appendix.The skill assumes a host or BlueField where DOCA / MFT is
already installed (mst tools present, debugfs mounted, sudo
available) and the target device is visible to mst status -v.
This skill is agent guidance, not a samples or scripts bundle. To keep the boundary clean, it deliberately does not contain — and pull requests should not add:
pcc_counters.sh has
exactly two operations (set, query), takes exactly two
positional arguments, and has NO --help, --version,
list, snapshot, watch, or diff. Do not invent any.samples/ or reference/ subtree. This is a thin
loader for a documented script; substantive material lives
in the script and the public PCC documentation.SKILL.md first to confirm the user's question
is in scope (reading the device's firmware PCC diagnostic
counters; not designing or loading a custom algorithm).configure, build,
modify, run, test, debug, plus the Command appendix — see TASKS.md.doca-pcc — the host-side
library for writing and loading custom congestion-control
kernels onto the DPA. It is a SEPARATE surface: the
firmware PCC diagnostic counters pcc_counters.sh reads
exist independently of any custom doca-pcc kernel, but an
operator tuning a custom algorithm may read these counters
to observe device-level CC behaviour. Conflating the script
(firmware counter readout) with the library (custom
algorithm load/control) is the most common PCC first-touch
error.doca-public-knowledge-map
— routing to the public DOCA / PCC documentation set,
including the firmware PCC algorithm configuration.doca-version — canonical
DOCA version-handling rules. The ## Version compatibility
section in CAPABILITIES.md is a concise
overlay that redirects here.doca-setup — env preparation,
install verification, mst tools, debugfs, and the
I have no install yet path with the public NGC DOCA
container. This skill assumes its preconditions are
satisfied.doca-debug — the
cross-cutting debug ladder. The PCC counter readout slots
in as a read-only device-state evidence source before any
congestion-control tuning recommendation is made.doca-programming-guide
— general DOCA programming patterns shared across the
bundle.© NVIDIA, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 7 other files in skills/doca-pcc-counters of NVIDIA/skills.
Open the folder on GitHubat commit 0e0d506
Doca Pcc Counters 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Doca Pcc Counters this skillNVIDIA/skills | 3.5k | — | ~3k | Automated safety check: Pass | Apache-2.0 | |
| Mole Bug Patternstw93/Mole | 69k | — | ~2k | Automated safety check: Pass | GPL-3.0 | |
| CLI DeveloperJeffallan/claude-skills | 12k | 1 repos | ~1.2k | Automated safety check: Pass | MIT | |
| JSON Processing with jqcharmbracelet/crush | 29k | — | ~746 | Automated safety check: Pass | Custom licence | |
| Shellm Architecture Referencelaude-institute/headlong | 1.2k | — | ~2k | Automated safety check: Notes | Apache-2.0 | |
| Cppcrazyguitar/cppcheatsheet | 290 | — | ~1.8k | Automated safety check: Pass | MIT |
tw93/Mole
A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.
Jeffallan/claude-skills
Walks through designing, building and polishing a command-line tool: user workflow and command hierarchy, implementation in commander, click, typer or cobra, completions and cross-platform testing.
charmbracelet/crush
Explains the jq command built into Crush for querying, filtering and reshaping JSON, including its supported flags and where it differs from standard jq.
laude-institute/headlong
Explains how shellm's bash-based recursive LLM shell fits together - its core engine, identity system, memory, skills and trajectory log.
crazyguitar/cppcheatsheet
Comprehensive C/C++ programming reference covering everything from C11-C23 and C++11-C++23, system programming, CUDA GPU computing, debugging tools, Rust interop, and advanced topics.
promovaweb/setupvibe
Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.
NVIDIA/skills
A skill your agent uses when the user wants to deploy, run, debug, tear down, or call the REST API of the RTVI-CV 2D detection / tracking microservice.
NVIDIA/skills
Generates, validates, compares and explains HOLOLINK_def.svh macro files for the HSB IP, using bundled Python scripts and asking before it writes anything.
NVIDIA/skills
Runs and validates an end-to-end Mission Control demo in a locally installed Isaac Sim, with a Nova Carter robot driven through a Python server.
NVIDIA/skills
Orchestrates defect image generation for PCBA, metal surface and glass inspection with NVIDIA Cosmos AnomalyGen on OSMO, from cold-start Day 0 to real-photo Day 1 labeling.
NVIDIA/skills
Orchestrates video data augmentation and auto-labeling workflows on OSMO, from flow selection and preflight checks to submission, monitoring and output download.
NVIDIA/skills
Runs NVIDIA TAO Data Services KPI analysis on object detection results, comparing predictions to ground truth and writing per-class precision, recall and AP to a CSV.
Works with
Categories
A skill your agent uses when the user is invoking the DOCA PCC Counters tool — the pcccounters.sh bash script under the DOCA tools directory — to arm and read the fixed firmware/hardware PCC…. Doca Pcc Counters is an agent skill from NVIDIA/skills, published by the product's own GitHub organization.) on a ConnectX / BlueField device via mst + the mlx5 debugfs diagcnt interface.
Doca Pcc Counters fits situations like: etc.) on a ConnectX / BlueField device via mst + the mlx5 debugfs diagcnt interface; even without pcccounters.sh; PCC counters: how do I read the CNP / RTT / WRED-drop counters; PCC counter stuck at zero.
Run `npx skills add NVIDIA/skills --skill doca-pcc-counters -a claude-code`. Or copy the skill folder (skills/doca-pcc-counters in NVIDIA/skills) into .claude/skills/doca-pcc-counters in your project. Claude Code loads it when a task matches its description.
Run `npx skills add NVIDIA/skills --skill doca-pcc-counters -a codex`. Or copy the skill folder (skills/doca-pcc-counters in NVIDIA/skills) into .agents/skills/doca-pcc-counters in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NVIDIA/skills --skill doca-pcc-counters -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doca-pcc-counters, .gemini/skills/doca-pcc-counters, .github/skills/doca-pcc-counters and .opencode/skills/doca-pcc-counters in your project.
SKILL.md names no scripts, command-line tools or credentials: Doca Pcc Counters is instructions for the agent only. Compatibility (from SKILL.md): Requires DOCA/MFT on Linux with a ConnectX-6 or newer or BlueField device, mst tools, mounted debugfs, and root access to the mlx5 diag_cnt interface. The script reads fixed firmware and hardware diagnostics independently of custom PCC code. Its set operation changes which counters are collected, not congestion-control or forwarding behavior; treat later fleet tuning as a separate high-stakes action. .
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.
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.
Doca Pcc Counters is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Doca Pcc Counters: Mole Bug Patterns (tw93/Mole, 69k stars), CLI Developer (Jeffallan/claude-skills, 12k stars), JSON Processing with jq (charmbracelet/crush, 29k stars) and Shellm Architecture Reference (laude-institute/headlong, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
NVIDIA (a GitHub organization, an official publisher) maintains it in NVIDIA/skills, which has 3,534 GitHub stars. The repository holds 380 skills in this directory. The repository was last updated on October 7, 2026.
Source: NVIDIA/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.