All skills
mblode avatar

/dx-audit

@b690e67
by Matthew Blodemblode/agent-skills134 stars
12

Audits libraries, CLIs, and SDKs using 38 rules for public contracts, package exports, piped output, errors, and configuration. Use when asked to "audit my CLI", "review my SDK", or diagnose package type resolution. For public site or docs agent scores use agent-ready; for agentic product trust use ax-audit; for docs prose use ghostwriter.

Use this Skill: https://skilld.dev/gh/mblode/agent-skills/dx-audit

This session only. Nothing lands on disk.

rulescli-exit-codes.md

≈331 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Exit 0 on Success, Non-Zero on Failure

Every script, Makefile, CI step, and agent loop branches on the exit code, often on nothing else. Exit 0 only on real success and non-zero on any failure; printing an error and exiting 0 passes a gate it should have failed. Where callers need to distinguish failure kinds, give each its own documented code (2 for usage errors is the long-standing convention) and keep the codes stable across releases. Set process.exitCode and return rather than calling process.exit(): stdout writes are asynchronous when piped, and exit() can cut off the very message that explains the failure.

Incorrect (prints an error but exits 0; CI thinks it passed):

if (errors.length) {
  console.error(`${errors.length} checks failed`);
}
process.exit(0); // always 0, even on failure

Correct (exit code reflects the outcome, and pending output flushes):

if (errors.length) {
  console.error(`${errors.length} checks failed`);
  process.exitCode = 1; // non-zero so &&, set -e, and CI all catch it
  return;
}
console.log("All checks passed");

Source: SKILL.md on GitHub

No alerts9d3 checks · Risk SAFE
  • Gen Agent Trust Hub9d

    The dx-audit skill is a developer experience auditing tool designed to review public APIs, CLIs, and SDKs. It demonstrates a strong security posture by including explicit instructions to validate inputs against path traversal and shell injection, and by warning the agent to inspect potentially malicious lifecycle scripts in audited repositories before running packaging probes. All external tools mentioned are industry-standard utilities.

  • Socket9d

    No alerts

  • Snyk9d

    Risk: LOW · No issues

Signed by skilld at b690e67. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last week

README badge

README badge for mblode/agent-skills/dx-audit