doc-rx

Evaluate documentation quality across 8 dimensions and 32 sub-metrics.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/acardozzo/rx-suite --skill doc-rx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-rx
Source: https://github.com/acardozzo/rx-suite/tree/main/skills/doc-rx
Command: npx skills add https://github.com/acardozzo/rx-suite --skill doc-rx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of poor project documentation, which hinders onboarding, increases maintenance costs, and frustrates developers. It ensures projects are understandable and maintainable.

Core Features & Use Cases

  • Comprehensive Audit: Evaluates documentation across 8 dimensions, including READMEs, API docs, code comments, ADRs, onboarding guides, changelogs, tutorials, and error messages.
  • Actionable Insights: Provides a scored scorecard, an opportunity map, and per-dimension improvement plans.
  • Use Case: A new developer joins a project and needs to understand its architecture and how to contribute. This Skill provides a clear roadmap of documentation gaps and prioritized actions to improve their onboarding experience.

Quick Start

Run the doc-rx skill to audit the documentation quality of the current project.

Frequently Asked Questions about doc-rx

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

FAQPage Schema
How do I audit documentation quality for a software project?

You can audit documentation quality by evaluating project readability across 8 dimensions including READMEs, API docs, code comments, ADRs, onboarding guides, changelogs, tutorials, and error messages. This process generates a scored report with actionable recommendations to improve developer experience.

What is developer experience documentation and why does it matter?

Developer experience documentation determines whether new developers can understand, onboard, and contribute to a project effectively. Poor documentation increases maintenance costs and frustrates developers, while a structured audit ensures projects remain understandable and maintainable over time.

How do I identify gaps in my project onboarding guide and API docs?

Identify gaps in onboarding guides and API docs by assessing them against 32 sub-metrics covering architecture understanding and contribution workflows. This evaluation produces an opportunity map and per-dimension improvement plans to prioritize missing information.

Can I evaluate architecture decision records and changelogs without external dependencies?

Yes, you can evaluate architecture decision records and changelogs without external dependencies. The audit runs as a standalone script using built-in references to assess technical writing completeness and generate a scorecard for your project's documentation.

What's the best way to improve technical writing and code comments for new developers?

The best way to improve technical writing and code comments is to run a comprehensive documentation audit. It assesses readability and coverage across 32 sub-metrics, providing a scorecard and prioritized action items to enhance the onboarding experience for new contributors.