skills.rest
Varnan-Tech
Varnan-TechOFFICIAL
Explore all skills by this author →
Website𝕏@varnan_labsGitHub

dx-roaster

Audit GitHub repositories across 10 developer experience dimensions and generate an action plan.

581|60|Updated Apr 13, 2026
Search Tags:#github#developer experience#dx audit#repo assessment#readme improvement
One-click install
npx skills add https://github.com/Varnan-Tech/opendirectory --skill dx-roaster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dx-roaster
Source: https://github.com/Varnan-Tech/opendirectory/tree/main/skills/dx-roaster
Command: npx skills add https://github.com/Varnan-Tech/opendirectory --skill dx-roaster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, npx, @opendirectory.dev/skills, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a comprehensive audit of your GitHub repo's developer experience, identifying areas for improvement and suggesting actionable steps to enhance it.

Core Features & Use Cases

  • Developer Experience Audit: Scores 10 dimensions of DX including clarity, visual proof, install simplicity, and more.
  • Customizable Tone: Write a roast in your chosen tone (brutal, honest, kind).
  • Actionable Plan: Prioritized list of fixes and improvements.
  • Ideal README Sketch: Sketch of what your README could be.
  • Use Case: Before any launch, to ensure your repo is user-friendly and accessible.

Quick Start

Run dx-roaster on your GitHub repo with npx "@opendirectory.dev/skills" install dx-roaster --target claude.

Frequently Asked Questions about dx-roaster

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

FAQPage Schema
How do I audit my GitHub repo's developer experience before launch?▼

Run a developer experience audit to score 10 dimensions like time-to-first-success and README clarity. The audit outputs a roast, a prioritized action plan, and an ideal README sketch.

What is a developer experience audit for GitHub repositories?▼

A developer experience audit evaluates GitHub repos by scoring 10 dimensions including README clarity, install simplicity, and community signals to identify areas for improvement and provide actionable fixes.

Can I use this DX audit with GitHub Copilot or Gemini CLI?▼

Yes, the DX audit requires GitHub access and supports execution through Claude Code, Gemini CLI, or GitHub Copilot to evaluate and enhance your repository.

How do I improve my README clarity and visual proof for developers?▼

Improve README clarity by running a DX audit that scores visual proof and documentation dimensions, then follow the provided prioritized action plan and ideal README sketch to implement fixes.

Does the developer experience roast support different feedback tones?▼

Yes, the developer experience roast supports customizable tones including brutal, honest, and kind, allowing you to choose the feedback style for your repo assessment.

Do I need npx installed to assess my repo's developer experience?▼

Yes, you need npx installed to run the DX assessment. You execute it via the command line using npx to install the skill and target your preferred CLI tool like Claude.

Related Skills

Explore More Software Engineering Skills→
Conte777Conte777

mcp-integration

Configure MCP servers and authenticate tools for Claude Code plugins.

Community
Intermediate
nathanvalenathanvale
2

dx-patterns

Design developer experience patterns for CLIs, toolchains, and documentation.

Community
Intermediate
magicpro97magicpro97
8

template-skill

Coordinate Claude Code, Codex CLI, and GitHub Copilot CLI for task management and verification.

Community
Advanced
a29paula29paul
1

health

Aggregate type checker, linter, test runner, and dead code detector results into a weighted 0-10 code quality score.

Community
Advanced