file-versioning

Enforces file naming and versioning conventions for all output files.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill file-versioning-gozonerd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-versioning
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/file-versioning
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill file-versioning-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams lose track of which document version is current, overwrite history with in-place edits, and apply inconsistent naming across files. This Skill enforces a single mandatory filename pattern and versioning discipline so every output file is unambiguous, superseded copies are preserved, and audit documents stay append-only. ## Core Features & Use Cases - Mandatory filename pattern: Every output file follows [PREFIX_][Description]_YYYY-MM-DD_vXX_[suffix].[ext], with date, version shortcode, and internal/external suffix rules. - Version increment logic: Distinguishes number bumps (fixes that supersede) from letter bumps (parallel iterations), and resolves ambiguous "bump the version" requests by asking the user. - Deprecation handling: Moves superseded files into a deprecated/ folder without renaming or deleting them, preserving history byte-identically. - Append-only vs version-up decision: Classifies documents as audit records (append-only, never edited) or live artifacts (versioned up), preventing amendment-stacked files. - Use Case: When saving a revised pipeline playbook, the Skill names it CLI-SM-DATS_Pipeline_Playbook_2026-03-22_v03_I.md, retires v02 to deprecated/ unchanged, and confirms the increment type. ## Quick Start Ask the assistant to name and save a new version of a document, for example by saying "version this file" or "bump the version on my playbook draft."

Frequently Asked Questions about file-versioning

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

FAQPage Schema
How do I name output files with a consistent versioning convention?

Use the pattern [PREFIX_][Description]_YYYY-MM-DD_vXX_[suffix].[ext], where the date records version creation, vXX is the version shortcode, and the suffix is _I for internal or _X for external. Underscores replace spaces throughout.

When should I bump a file version number versus a letter?

Bump the number when the change is a fix that supersedes the prior version, such as a new rule or structural reorganization. Bump the letter when creating a parallel alternative iteration, since both letter variants remain valid.

What should I do with old versions of a file?

Move superseded files into a deprecated/ subfolder without renaming or deleting them. Location carries the retired signal, so the file stays byte-identical and recoverable.

Should a change log or decision log be versioned like other documents?

No. Audit documents such as gate logs, decision logs, and change logs are append-only: never edit an entry, and record corrections as new entries naming the entry they correct. Only artifacts stating current truth get versioned up.

How do I find the latest version of a file in a directory?

Check the directory for the highest version number, then look for an active UPDATE_BACKLOG file. If a backlog exists, state the base version plus pending update count and ask whether to work from base or apply the backlog.