A custom slash command for Claude Code that audits open-source projects against best practices from Producing Open Source Software by Karl Fogel.
/audit-oss examines a project directory and scores it against a 60-item checklist covering 10 categories:
| Category | What it checks |
|---|---|
| Identity | Name, mission statement, status, license visibility |
| Documentation | README, quickstart, tutorials, CHANGELOG |
| Contributor Experience | CONTRIBUTING.md, CoC, issue templates, dev setup |
| Infrastructure | CI/CD, linting, branch protection, dependency tracking |
| Releases | Versioning, semver, packaging, security releases |
| Legal | LICENSE file, metadata, compatibility, contributor agreements |
| Governance | Decision-making, maintainer roles, public discussions |
| Communication | Channels, announcements, security reporting |
| Automation | Tests, coverage, stale issue management, reproducibility |
| Health | Activity, contributors, roadmap |
Output is a scorecard with scores, top priorities, and quick wins.
curl -fsSL https://raw.githubusercontent.com/zhiganov/claude-audit-oss/master/install.sh | bashirm https://raw.githubusercontent.com/zhiganov/claude-audit-oss/master/install.ps1 | iex- Copy
audit-oss.mdto~/.claude/commands/audit-oss.md - Copy
oss-audit-checklist.mdto~/.claude/oss-audit-checklist.md
/audit-oss <project-directory>
/audit-oss <project-directory> --focus <category>
/audit-oss my-project # Full audit (all 10 categories)
/audit-oss my-project --focus legal # Audit only licensing & legal
/audit-oss my-project --focus docs # Audit only documentation
identity, docs, contributor, infra, releases, legal, governance, communication, automation, health
- Claude reads the checklist from
~/.claude/oss-audit-checklist.md - Examines the project: README, LICENSE, CI configs, package metadata, git history, etc.
- Scores each item:
[x]present,[~]partial,[ ]missing,[n/a]not applicable - Outputs a scorecard with top priorities and quick wins
- Optionally saves results to
{project}/OSS-AUDIT.md
The checklist at ~/.claude/oss-audit-checklist.md is plain markdown. Add, remove, or modify items to match your project standards. The audit command reads it fresh each time.
MIT