Bootstrap Skill Diff Tool (Compare Versions)
Author: yusufkaraaslanCreated Jan 20, 2026Updated Jan 20, 2026
Labelspriority: mediumtype: enhancementworkflowbootstrap
Overview
Create tool to compare bootstrap skills across git tags/versions.
Motivation
- Track codebase evolution over time
- Detect breaking API changes
- Validate refactoring impacts
- Automate release notes generation
Implementation
Create scripts/diff_bootstrap_skills.sh:
#!/bin/bash
VERSION_1=\$1 # e.g., v2.7.0
VERSION_2=\$2 # e.g., v2.8.0
# Generate skill for version 1
git checkout \$VERSION_1
./scripts/bootstrap_skill.sh
mv output/skill-seekers output/skill-seekers-\$VERSION_1
# Generate skill for version 2
git checkout \$VERSION_2
./scripts/bootstrap_skill.sh
mv output/skill-seekers output/skill-seekers-\$VERSION_2
# Diff pattern counts
echo "Pattern Detection Changes:"
jq '.total_patterns' output/skill-seekers-\$VERSION_1/patterns/detected_patterns.json
jq '.total_patterns' output/skill-seekers-\$VERSION_2/patterns/detected_patterns.json
# Diff API surface
echo "API Changes:"
diff <(ls output/skill-seekers-\$VERSION_1/api_reference/) \
<(ls output/skill-seekers-\$VERSION_2/api_reference/)
# Diff config count
echo "Configuration Changes:"
jq '.total_settings' output/skill-seekers-\$VERSION_1/config_patterns/*.json
jq '.total_settings' output/skill-seekers-\$VERSION_2/config_patterns/*.jsonExample Output
Pattern Detection Changes:
v2.7.0: 85 patterns
v2.8.0: 90 patterns (+5 patterns detected)
API Changes:
+ config_manager.md
+ resume_command.md
+ rate_limit_handler.md
Configuration Changes:
v2.7.0: 2,650 settings
v2.8.0: 2,856 settings (+206 settings)Benefits
- ✅ Track codebase evolution
- ✅ Detect breaking changes
- ✅ Validate refactorings
- ✅ Automate release notes
Use Cases
- Release preparation
- API change validation
- Documentation updates
Effort
~3 hours
Priority
Medium
Related
See: docs/features/BOOTSTRAP_SKILL_TECHNICAL.md
Source: yusufkaraaslan/Skill_Seekers