docs-sync

Cross-reference source code against documentation to identify missing or outdated content.

17.6k|2.0k|Updated Sep 14, 2010
One-click install
npx skills add https://github.com/redis/node-redis --skill docs-sync-redis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-sync
Source: https://github.com/redis/node-redis/tree/main/.agents/skills/docs-sync
Command: npx skills add https://github.com/redis/node-redis --skill docs-sync-redis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Project documentation often falls out of sync with codebase changes, leading to missing, outdated, or incorrect information that confuses users and increases support burden for engineering teams.

Core Features & Use Cases

  • Doc Coverage Auditing: Compares master branch (or current branch diff) implementation against existing docs in docs/, top-level README.md, and per-package READMEs to identify gaps.
  • Inaccuracy Detection: Flags outdated default values, removed features, renamed configuration options, and missing documentation for new commands or client behaviors.
  • Use Case: For the node-redis repository, this skill can catch that a new Redis cluster connection string option added in the client code is missing from the clustering documentation, or that a command's documented default timeout does not match the implementation.

Quick Start

Ask the docs-sync skill to audit the current branch's documentation against the master branch code and generate a report of all missing, outdated, or incorrect content.

Frequently Asked Questions about docs-sync

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

FAQPage Schema
How do I audit documentation against my codebase to find outdated content?

Documentation gap detection works by cross-referencing source code implementation against existing documentation assets like top-level READMEs, per-package READMEs, and dedicated docs directories to identify missing, outdated, or incorrect content for features and configuration options.

Can I detect missing documentation for new configuration options in my repository?

Yes, you can detect missing documentation for new configuration options by comparing the current branch implementation against existing docs. This flags missing docs for new commands, client behaviors, and renamed options that exist in the code but lack documentation coverage.

What is the best way to check for code-doc alignment before a release?

The best way to check for code-doc alignment before a release is to perform a pre-release audit that cross-references the master branch implementation against existing documentation assets. This identifies outdated default values, removed features, and incorrect command behaviors to ensure docs match the implementation.

Does documentation maintenance work for per-package READMEs and top-level docs?

Yes, documentation maintenance works for per-package READMEs and top-level docs. The process applies to repositories with structured documentation sets, auditing dedicated docs directories and README files to ensure project documentation stays perfectly aligned with codebase changes.

What type of inaccuracies can a documentation audit catch in a codebase?

A documentation audit can catch inaccuracies such as outdated default values, removed features, renamed configuration options, and missing documentation for new commands or client behaviors by cross-referencing the actual source code implementation against existing documentation assets.

When should I run a documentation gap detection workflow for ongoing maintenance?

You should run a documentation gap detection workflow during ongoing maintenance, post-feature doc updates, and pre-release audits. Running it against the current branch diff or master branch implementation ensures documentation stays aligned with continuous codebase changes.