add-best-practice

Add new best practice entries to Markdown files with unique IDs.

1|1|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/brave-experiments/brave-core-tools --skill add-best-practice-brave-experiments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-best-practice
Source: https://github.com/brave-experiments/brave-core-tools/tree/main/.claude/skills/add-best-practice
Command: npx skills add https://github.com/brave-experiments/brave-core-tools --skill add-best-practice-brave-experiments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, git, gh, pwd, ls, grep, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of adding new best practice guidelines to the project's documentation, ensuring consistency, proper formatting, and preventing duplicate entries.

Core Features & Use Cases

  • Duplicate Checking: Prevents adding rules that are already documented.
  • ID Assignment: Automatically assigns stable, unique IDs to new best practices.
  • Categorization: Helps place new rules into the correct documentation files.
  • Use Case: A developer identifies a new coding pattern that should be a best practice. They use this skill to add it to the coding-standards.md file, complete with a clear description, code examples, and a unique ID.

Quick Start

Add a new best practice about error handling in asynchronous operations to the documentation.

Frequently Asked Questions about add-best-practice

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

FAQPage Schema
How do I add new best practices to markdown documentation?

To add best practices to markdown documentation, this Skill formats new entries based on predefined templates, assigns stable IDs via a Python script, and validates against existing rules to prevent duplicates.

How do I prevent duplicate coding standards in my documentation files?

Preventing duplicate coding standards is handled automatically by validating new best practice entries against existing rules within the specified directory before any markdown files are modified or updated.

Can I automatically assign stable IDs to best practice entries in markdown?

Yes, you can automatically assign stable IDs to best practice entries by running the integrated Python script, ensuring every new rule added to your documentation receives a unique and permanent identifier.

Does this Skill require git and gh to categorize best practices?

While it categorizes best practices into predefined files, the Skill lists both git and gh as dependencies, alongside python3 and standard shell utilities, to manage and execute its documentation scripts.

What is the best way to format coding standards in markdown files?

The best way to format coding standards is using the predefined markdown templates included in the Skill, which ensure consistent structure for descriptions, code examples, and unique identifiers across all entries.

How do I organize new best practices into predefined documentation categories?

To organize new best practices into predefined categories, the Skill places formatted entries into specific markdown document files based on their topic, ensuring all coding standards are logically structured.