---
name: MD Audit
slug: md-audit
category: Quality
description: "MD Audit scans the current working directory for common code issues and returns a prioritized findings report without editing files. Use it when asked to audit code, find issues, or see what's wrong with a codebase."
github: "https://github.com/chaitanyagiri/munder-difflin/tree/main/resources/skills/md-audit"
language: TypeScript
stars: 2178
forks: 253
install: "npx degit https://github.com/chaitanyagiri/munder-difflin/tree/main/resources/skills/md-audit ~/.claude/skills/md-audit"
installs_to: ~/.claude/skills/md-audit
source_path: resources/skills/md-audit/SKILL.md
collection_size: 17
category_size: 1354
collection_url: "https://dirskills.com/collections/chaitanyagiri/munder-difflin"
added: 2026-08-19T07:25:44.341Z
last_synced: 2026-08-19T07:25:44.341Z
canonical_url: "https://dirskills.com/skills/md-audit"
---

# MD Audit

MD Audit scans the current working directory for common code issues and returns a prioritized findings report without editing files. Use it when asked to audit code, find issues, or see what's wrong with a codebase.

**Install:**

```bash
npx degit https://github.com/chaitanyagiri/munder-difflin/tree/main/resources/skills/md-audit ~/.claude/skills/md-audit
```

## README

## Code Audit (read-only)

Perform a read-only code quality scan and return a findings report. Do NOT edit any files.

Steps:
1. **Scope** — identify the primary language and entry points (`package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, or similar).
2. **Scan** — use `Grep` and `Read` to look for:
   - Unhandled promise rejections / ignored errors
   - Hard-coded secrets or credentials (keys, tokens, passwords)
   - `TODO`/`FIXME`/`HACK` comments that signal known debt
   - Dead exports (exported symbols with no in-repo import)
   - Obvious type-safety gaps (unchecked `any`, missing null guards)
3. **Report** — output a findings list sorted by severity (Critical → High → Medium → Low):
   ```
   ## Audit Report — <project name>

   ### Critical
   - [file:line] <description>

   ### High
   - ...

   ### Summary
   <total count> findings across <file count> files scanned.
   ```
4. Stop after reporting. Do not apply any fixes.