fix-bp-docs

Audit and correct best practices markdown for stale references and duplicates.

1|1|Updated Feb 27, 2026

Search Tags:#code quality #best practices #documentation #markdown #content management #auditing

Ready to run

npx skills add https://github.com/brave-experiments/brave-core-tools --skill fix-bp-docs-brave-experiments

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: fix-bp-docs
Source: https://github.com/brave-experiments/brave-core-tools/tree/main/.claude/skills/fix-bp-docs
Command: npx skills add https://github.com/brave-experiments/brave-core-tools --skill fix-bp-docs-brave-experiments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures the accuracy, consistency, and up-to-dateness of best practices documentation by identifying and rectifying issues like stale references, duplicate content, and formatting errors.

Core Features & Use Cases

Duplicate Content Detection: Identifies and helps resolve redundant rules across documentation.
Stale Reference Correction: Updates or flags incorrect file and symbol references within code examples.
Formatting Validation: Checks for and corrects common markdown and anchor ID formatting issues.
Index Consistency: Verifies that the main index file accurately reflects all documentation.
Use Case: Maintain a high standard of technical documentation by automatically auditing and fixing broken links, outdated code snippets, and duplicated guidelines in your project's best practices.

Quick Start

Run the fix bp docs skill from the brave-core-tools directory to audit and correct best practices documentation.

Frequently Asked Questions about fix-bp-docs

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

FAQPage Schema

How do I audit markdown documentation for stale references and formatting issues?▼

To audit markdown documentation for stale references and formatting issues, use a tool that validates internal and external file paths, checks symbol references, and corrects markdown structure within your best practices directories.

What is the best way to fix duplicate content in best practices docs?▼

The best way to fix duplicate content in best practices docs is to run an auditing script that identifies redundant rules across your markdown files and helps resolve them automatically.

Do I need Python3 to run documentation auditing and correction scripts?▼

Yes, you need Python3 installed in your environment to run the documentation auditing and correction scripts that identify stale references, duplicates, and formatting errors in markdown files.

How do I validate the BEST-PRACTICES.md index file against individual markdown files?▼

To validate the BEST-PRACTICES.md index file against individual markdown files, run an auditing process that verifies index consistency, ensuring the main index accurately reflects all documentation within the docs/best-practices directory.

Can I automatically correct broken file paths and anchor IDs in markdown documentation?▼

Yes, you can automatically correct broken file paths and anchor IDs in markdown documentation by running an auditing tool that validates and fixes common markdown structure and formatting issues.

Why does my markdown documentation audit fail when checking internal symbol references?▼

Your markdown documentation audit may fail when checking internal symbol references if the code examples contain outdated or incorrect file and symbol references that no longer match the actual codebase structure.