# audit

Adopt this skill: https://proskills.md/skills/other/jhostalek-dotclaude-skills-audit

Page: https://proskills.md/skills/other/jhostalek-dotclaude-skills-audit
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/audit/SKILL.md
size: 580
upstream: https://github.com/jhostalek/dotclaude/blob/main/skills/audit/SKILL.md

```text
---
name: audit
description: Run an explicitly selected code or UX audit, or a full fourteen-dimension sweep.
argument-hint: "[full|dimension...] [path] [review only]"
disable-model-invocation: true
---

Audit `$ARGUMENTS` using [the shared workflow](references/workflow.md). It defines scope, lens selection, evidence, corrections, and completion. Read only the selected lenses; read [integration](references/integration.md) for multiple dimensions.

Examples: `/audit security src/auth`, `/audit correctness contracts src/api review only`, `/audit ux /settings`, `/audit full`.
```

## File: README.md
upstream: https://github.com/jhostalek/dotclaude/blob/main/README.md

````text
# dotclaude

skills for agentic coding tools. extremely opinionated. updated (almost) daily.

> **heads up:** this is a global `~/.claude` configuration repo — skills that apply across all projects. project-specific instructions (`CLAUDE.md`, `TOOLS.md`, skills) live in individual repositories.

### build

start here. `intent-brief` clarifies intent, `sota` finds a current expert recommendation, and `design` explores alternatives.

| skill | |
|-------|-|
| `intent-brief` | evidence-first intent brief with questions reserved for hard-to-reverse decisions |
| `sota` | current expert recommendation grounded in brief web research |
| `design` | divergent exploration with independent reasoning agents |

### quality

before you ship. review what you built, refactor what's messy, audit what's bloated or stale.

| skill | |
|-------|-|
| `judge` | independent expert review before accepting work |
| `audit` | independent reviews through focused audit dimensions |
| `writing` | rewrite AI slop into text a person would write |
| `distill` | compress rough text into expert-register English |
| `query-refiner` | rewrite a rough question into a precise expert query |

use `/audit <dimension> [path]` for a focused review, `/audit full` for all code dimensions, or `/audit ux` for usability. each dimension gets one independent reviewer of the whole scope. audits are read-only; scope defaults to changed files.

### ship

git workflow from branch to PR to merge.

| skill | |
|-------|-|
| `git-workflow` | commit, PR, merge, and rebase conventions |
| `timesheet` | monthly timesheet entries from git |

### when they run

in Claude and Codex, `git-workflow` and `query-refiner` load automatically when relevant. all other skills require explicit invocation.

use `/name` for standalone skills in Claude, or select the skill with `$` in Codex.

Use `/writing` or `$writing` to rewrite the last agent response. Add text, a file, or feedback to choose a different target or explain what should change.

## install

### Codex plugin

Add the marketplace and install the plugin:

```bash
codex plugin marketplace add JHostalek/dotclaude
codex plugin add jhostalek-skills@jhostalek
```

### Claude Code plugin

Add the marketplace and install the plugin:

```text
/plugin marketplace add JHostalek/dotclaude
/plugin install jhostalek-skills@jhostalek
```

Skills are versioned with the plugin and invoked as
`/jhostalek-skills:<skill-name>`. The plugin contains skills only.

### Pi package

Install directly from Git:

```bash
pi install git:github.com/JHostalek/dotclaude
```

Invoke skills as `/skill:<skill-name>`. Use `pi update --extensions` to update
the package.

### releases

Claude Code, Codex, and Pi share one semantic version. Releases use annotated
`vMAJOR.MINOR.PATCH` tags and are recorded in [CHANGELOG.md](CHANGELOG.md).
See [RELEASING.md](RELEASING.md) for the release procedure.

### Editable standalone skills

Symlink the skills you use from the source checkout:

```bash
git clone git@github.com:JHostalek/dotclaude.git ~/dotclaude
mkdir -p ~/.claude/skills
ln -s ~/dotclaude/skills/git-workflow ~/.claude/skills/git-workflow
```

For Codex, use `~/.codex/skills` as the link destination.

## contributing

this project is owned and maintained by me alone. issues and pull requests are not accepted.

## license

[CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) — public domain.
````
