document-naming-convention

Enforces naming conventions for ADR and plans directories via regex validation and bulk renaming.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/cc01cc/cmtx-project --skill document-naming-convention
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-naming-convention
Source: https://github.com/cc01cc/cmtx-project/tree/main/.kilo/skills-repo/shared/document-naming-convention
Command: npx skills add https://github.com/cc01cc/cmtx-project --skill document-naming-convention

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Establishes a mandatory, consistent naming pattern for decision and planning documents (e.g., adr/, plans/), reducing confusion and enabling automated validations and ordering across repositories.

Core Features & Use Cases

  • Enforces uppercase category prefixes and hyphen separators in file names to improve readability and standardization.
  • Provides automated numbering and per-category sequencing to avoid conflicts and simplify discovery.
  • Includes a built-in validator and bulk-renaming guidance to enforce compliance across large directories.

Quick Start

Audit the current ADR and plans directories to identify non-compliant names and compute the next compliant filename.

Frequently Asked Questions about document-naming-convention

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

FAQPage Schema
How do I enforce consistent naming for ADR and planning documents?

To enforce consistent ADR and planning document naming, apply uppercase category prefixes and hyphen separators to filenames in adr/ and plans/ directories. This standardizes document discovery and enables automated validation across repositories.

What's the best way to bulk rename non-compliant decision records?

The best way to bulk rename decision records is to audit the adr/ and plans/ directories to identify non-compliant names, then apply the built-in validator and renaming guidance to calculate and apply the correct numeric sequencing.

How does automated numeric sequencing prevent file naming conflicts?

Automated numeric sequencing prevents file naming conflicts by assigning per-category sequential numbers to each document. It checks for existing collisions within adr/ and plans/ directories to ensure every filename is unique and ordered correctly.

Can I validate document names using regex patterns across large directories?

Yes, you can validate document names using regex patterns across large directories. The built-in validator checks filenames against regex rules to ensure they satisfy category prefixing, numeric sequencing, and hyphen separator compliance.

Does this naming convention approach work for directories beyond ADR and plans?

Yes, this naming convention approach works for directories beyond ADR and plans. It applies to creating, renaming, and validating docs within any similar decision directories, producing metadata for discovery and audits.