# Skill Version Aware

> Track and manage Agent Skill versions using Git-backed versioning. Provides change summaries, behavior regression detection, dependency validation, and one-click rollback. Use when updating Skills, reviewing changes, or diagnosing post-update issues.

- Skill: `liber1917/skill-version-aware` (Agent Skill)
- Install (CLI): `npx skillmds@latest add liber1917/skill-version-aware`
- Raw SKILL.md: https://api.skillmd.com/api/skills/liber1917/skill-version-aware/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Liber1917 (https://skillmd.com/u/liber1917)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/liber1917/skill-version-aware

---


# Skill Version Awareness

Track and manage Agent Skill versions with change visibility and rollback capability.

## Core Capabilities

### 1. Version Fingerprinting
- Hash-based version identification (SHA-256 of SKILL.md content)
- Git commit SHA for repository-backed skills
- Semantic versioning for published skills

### 2. Change Summary
- Diff-based change detection between versions
- LLM-generated natural language summary of changes
- Classification: trigger change, output change, tool change, structural change

### 3. Dependency Validation
- Track external tool dependencies (CLI tools, APIs, packages)
- Validate dependencies are still available after update
- Detect dependency version conflicts

### 4. Behavior Regression Detection
- Compare test results before and after update
- Flag new test failures as potential regressions
- Generate regression report with before/after comparison

### 5. One-Click Rollback
- Git-based rollback to any previous version
- Preserve rollback history
- Validate skill functionality after rollback

## Workflow

### Before Update
1. Run current version's test suite → save baseline
2. Record current fingerprint

### After Update
1. Compute new fingerprint
2. Generate change summary (diff + LLM)
3. Validate dependencies
4. Run test suite → compare with baseline
5. If regressions detected: present report, offer rollback

## Report Format

```
## Version Update Report: [Skill Name]

**Before:** [fingerprint/commit]
**After:** [fingerprint/commit]

### Changes
- [Change summary in natural language]

### Dependency Check
| Dependency | Status | Notes |
|-----------|--------|-------|
| tool-name | OK/MISSING | ... |

### Behavior Regression
| Test | Before | After | Status |
|------|--------|-------|--------|
| test-id | PASS | PASS/FAIL | REGRESSION/OK |

### Recommendation
[Proceed / Rollback / Investigate]
```