sync-versions

Extract container image tags from blueprint_files.tf and update SOFTWARE_VERSIONS.md.

3|2|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/oci-ai-incubations/ai-accelerator-starter-packs --skill sync-versions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-versions
Source: https://github.com/oci-ai-incubations/ai-accelerator-starter-packs/tree/main/.claude/skills/sync-versions
Command: npx skills add https://github.com/oci-ai-incubations/ai-accelerator-starter-packs --skill sync-versions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync SOFTWARE_VERSIONS.md with container image versions defined in blueprint_files.tf. Run this skill before deploying to ensure the versions doc is current.

Core Features & Use Cases

  • Parse ai-accelerator-tf/blueprint_files.tf to extract every container image reference, including fields like container_image and image.
  • Update SOFTWARE_VERSIONS.md to match the extracted images, organizing them by starter pack (cuopt, vss, paas_rag, enterprise_rag, enterprise_rag_aiq) and size (small, medium) as defined in the repository.
  • Flag and report discrepancies (version changes, new images, removed images) and apply changes while preserving the existing table structure.

Quick Start

Run this skill to synchronize SOFTWARE_VERSIONS.md with the container image references found in blueprint_files.tf.

Frequently Asked Questions about sync-versions

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

FAQPage Schema
How do I sync container image versions in Terraform with a Markdown documentation file?

You can sync container image versions by scanning the Terraform blueprint_files.tf file for image fields and updating SOFTWARE_VERSIONS.md to match the extracted tags. The process groups images by starter pack and size while preserving the existing table formatting.

What is the best way to track version changes in container images before deploying?

The best way to track version changes is by comparing extracted container image references from Terraform against the existing SOFTWARE_VERSIONS.md documentation. This flags version changes, new images, and removals before deployment to ensure docs are current.

Can I automatically update a versions doc to match container image references in a Terraform file?

Yes, you can automatically update a versions doc by parsing the blueprint_files.tf Terraform file for container_image and image fields. The extracted tags are applied directly to SOFTWARE_VERSIONS.md while maintaining the repository's starter pack and size structure.

Does this version synchronization process preserve the existing table structure in the documentation?

Yes, the version synchronization process preserves the existing table structure in SOFTWARE_VERSIONS.md. It applies changes by grouping extracted container images into the predefined starter pack and size categories without breaking the original documentation formatting.

When do I need to synchronize my container version docs with Terraform files?

You should synchronize your container version docs with Terraform files right before deploying to ensure the SOFTWARE_VERSIONS.md file accurately reflects the container image tags defined in blueprint_files.tf. This prevents documentation drift during releases.

Why does my SOFTWARE_VERSIONS.md file show outdated container image tags?

Your SOFTWARE_VERSIONS.md file shows outdated container image tags because it was not updated after changes were made to the blueprint_files.tf Terraform configuration. Synchronizing the files resolves this by extracting current image tags and updating the documentation.