DX Audit Skill

Audit codebases for documentation, navigation, naming, and environment setup gaps.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/HermeticOrmus/hermetic-claude --skill dx-audit-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: DX Audit Skill
Source: https://github.com/HermeticOrmus/hermetic-claude/tree/main/claude/skills/dx-audit
Command: npx skills add https://github.com/HermeticOrmus/hermetic-claude --skill dx-audit-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill systematically audits and improves the developer experience within a codebase, addressing friction points related to onboarding, code navigation, documentation, and setup.

Core Features & Use Cases

  • Documentation Audit: Checks for essential files like READMEs, CLAUDE.md, and architecture docs.
  • Code Navigation Clarity: Assesses the organization and documentation of components, composables, and API routes.
  • Naming Consistency: Identifies and suggests fixes for naming conflicts and inconsistencies.
  • Environment Setup: Verifies the presence and quality of .env.example files.
  • Use Case: A new developer joins a project and struggles to understand where to start or how to set up their local environment. Running this skill provides a clear roadmap of documentation gaps and setup issues, accelerating their onboarding.

Quick Start

Run the dx-audit skill to analyze the current project's developer experience and identify areas for improvement.

Frequently Asked Questions about DX Audit Skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve developer experience and reduce onboarding friction in my codebase?

A codebase developer experience audit systematically checks documentation, code navigation, naming consistency, and environment setup to identify friction points for new developers. It generates actionable improvements and documentation templates to enable quick orientation and productivity.

What is the best way to audit codebase documentation for new developer onboarding?

The best way to audit codebase documentation is to check for essential files like READMEs, CLAUDE.md, and architecture docs. Assessing the organization of components and API routes ensures new developers can quickly navigate the project and understand where to start.

How do I check if my environment setup and .env.example files are ready for new developers?

You can check environment setup readiness by verifying the presence and quality of .env.example files. An audit scans for these configuration templates to ensure new team members can easily set up their local environment without missing variables.

Can I use an automated audit to fix naming conflicts and inconsistencies in my codebase?

Yes, you can use a developer experience audit to identify naming conflicts and inconsistencies across your codebase. The audit assesses code navigation clarity and suggests fixes for naming issues to help team members understand the project structure faster.

Does the developer experience audit work without any external dependencies or setup?

Yes, the developer experience audit works without external dependencies. It runs directly on your current project to analyze documentation gaps, code navigation issues, and setup problems, accelerating onboarding without requiring additional environment configuration.