| name | skill-version-aware |
| description | 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 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
- Run current version's test suite → save baseline
- Record current fingerprint
After Update
- Compute new fingerprint
- Generate change summary (diff + LLM)
- Validate dependencies
- Run test suite → compare with baseline
- 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]
