Arkhe-claude-plugins spring-refresh
Check Spring Boot skill content freshness against latest research and flag skills needing updates. Use when running /spring-refresh, or when user mentions "refresh spring skills", "spring boot update check", "skill freshness", "stale spring content", "update spring boot skills".
git clone https://github.com/joaquimscosta/arkhe-claude-plugins
T=$(mktemp -d) && git clone --depth=1 https://github.com/joaquimscosta/arkhe-claude-plugins "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/spring-boot/skills/spring-refresh" ~/.claude/skills/joaquimscosta-arkhe-claude-plugins-spring-refresh && rm -rf "$T"
plugins/spring-boot/skills/spring-refresh/SKILL.mdSpring Boot Skill Freshness
Check whether Spring Boot skills are current with the latest research docs.
Arguments
Parse
$ARGUMENTS for mode:
(default, no args) — Scan and report freshnesscheck
— Update research docs via deep-research, then reportrefresh
— Help update a specific skill's contentupdate <skill-name>
Mode: check
- Run the freshness scanner:
python3 ${CLAUDE_SKILL_DIR}/scripts/scan_skill_freshness.py --format json ${CLAUDE_SKILL_DIR}/../..
-
Parse the JSON output and present a formatted report with:
- Research doc staleness table (file, version, last updated, age, status)
- Skill drift table (name, target version, last modified, research date, drift, status)
- Summary counts (up-to-date, needs review, needs update)
-
For skills with
orNEEDS_REVIEW
:NEEDS_UPDATE- List which research docs they depend on
- Suggest running
for each/spring-refresh update <skill-name>
Mode: refresh
-
For each Spring Boot research doc, invoke the Skill tool with
to refresh:core:deep-research
(for ecosystem-research.md)refresh spring-boot-ecosystem
(for ddd-implementation.md)refresh spring-boot-ddd-implementation
(for security-observability-testing.md)refresh spring-boot-security-observability-testing
-
After all research docs are refreshed, run the
mode to produce the updated report.check -
Show a before/after comparison of research doc dates.
Fallback: If the deep-research skill is not available, skip the research refresh and run
check mode only. Inform the user they can manually update research docs.
Mode: update <skill-name>
-
Run
mode first to identify drift status for the specified skill.check -
Read the research docs that map to this skill:
→ scanner, verify, web-api, data-ddd, modulith, domain-driven-designspring-boot-ecosystem-research.md
→ domain-driven-design, data-ddd, web-api, modulithspring-boot-ddd-implementation.md
→ security, observability, testingspring-boot-security-observability-testing.md
-
Read the skill's current content: SKILL.md, EXAMPLES.md, TROUBLESHOOTING.md, and all files in references/.
-
Compare research content against skill content. Identify:
- New APIs or patterns in research not covered in the skill
- Deprecated patterns in the skill that research has replaced
- Version-specific changes (e.g., new Spring Boot minor version features)
-
Present proposed changes to the user for confirmation before editing.
-
After updates, bump the
field if targeting a new version.spring-boot-version
Output Format
## Spring Boot Skill Freshness Report ### Research Documents | Document | Version | Updated | Age | Status | |----------|---------|---------|-----|--------| ### Skills | Skill | Target | Modified | Research | Drift | Status | |-------|--------|----------|----------|-------|--------| ### Recommendations - [actionable items]
References
- EXAMPLES.md for usage examples
- TROUBLESHOOTING.md for common issues
- Research docs (local):
docs/research/spring-boot-*.md - Research docs on GitHub