fix-specs

Normalize legacy SPEC filenames to date+slug format with a Python script.

Updated May 31, 2026
One-click install
npx skills add https://github.com/zizzfizzix/agentic-engineering-framework --skill fix-specs-zizzfizzix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-specs
Source: https://github.com/zizzfizzix/agentic-engineering-framework/tree/main/core/ai/skills/fix-specs
Command: npx skills add https://github.com/zizzfizzix/agentic-engineering-framework --skill fix-specs-zizzfizzix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill normalizes legacy spec filenames, ensuring consistency and aiding in link updates for repositories with legacy naming conventions.

Core Features & Use Cases

  • Filename Normalization: Converts legacy SPEC-* or SPEC-ENT-* filenames to a date+slug format.
  • Conflicts Resolution: Handles filename collisions by keeping older filenames and modifying newer ones.
  • In-file References Update: Automatically updates filename references and links within files.
  • Use Case: Use this Skill after migrating to a new naming convention to update all references to the new filenames in your repository.

Quick Start

Run the dry run to review changes and apply them after verification: python3 .ai/skills/fix-specs/scripts/fix_spec_conflicts.py --apply

Frequently Asked Questions about fix-specs

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

FAQPage Schema
How do I standardize legacy spec filenames in a repository?

To standardize legacy spec filenames, you can normalize them to a date+slug format to resolve conflicts and update file references. This process ensures consistency across the repository after migrating to a new naming convention.

How do I update in-file references when changing spec document filenames?

Updating in-file references during spec filename normalization is handled automatically by the script. It modifies legacy naming conventions and resolves collisions while updating all internal links to match the new filenames.

What is the best way to resolve filename collisions when normalizing spec documents?

The best way to resolve filename collisions during spec document normalization is to keep the older filename and modify the newer one. This conflict resolution mechanism prevents data loss when multiple files share similar legacy names.

Do I need Python 3 to normalize spec filenames in my repository?

Yes, you need Python 3 installed to normalize spec filenames in your repository. The standardization script runs using Python 3 and requires a repository containing spec files that need naming convention updates.

Can I preview spec filename changes before applying them to my repository?

Yes, you can preview spec filename changes by running a dry run before applying them. This allows you to review all filename normalization and reference updates, verifying accuracy before committing the changes.

When should I use a filename normalization script for spec documents?

You should use a filename normalization script for spec documents after migrating to a new naming convention. It is specifically designed to update all references to new filenames when dealing with legacy naming formats like SPEC- or SPEC-ENT- prefixes.