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.