skill-updater

Back up, validate, and refresh installed Codex skills under $CODEX_HOME.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/metric-space-ai/ctox --skill skill-updater-metric-space-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-updater
Source: https://github.com/metric-space-ai/ctox/tree/main/skills/system/skill_meta/skill-updater
Command: npx skills add https://github.com/metric-space-ai/ctox --skill skill-updater-metric-space-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Update and modify already installed Codex skills under $CODEX_HOME/skills or $CODEX_HOME/skills/.system. Use when a user wants to change an installed skill, refresh its metadata, validate it, or make a safety backup before editing.

Core Features & Use Cases

  • Backup installed skill directories before making non-trivial changes to preserve state.
  • Validate the skill structure and metadata to ensure compatibility with the runtime.
  • Regenerate agents/openai.yaml to reflect updated UI metadata after edits.

Quick Start

Run the updater against the target skill directory to back up, validate, and refresh its metadata and OpenAI YAML.

Frequently Asked Questions about skill-updater

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

FAQPage Schema
How do I back up Codex skills before modifying or upgrading them?

To back up Codex skills, run the updater against your target skill directory to create a safety backup. The tool duplicates installed skill files before applying edits, ensuring you can safely modify or upgrade skills without losing the original configuration.

What is the best way to validate a modified Codex skill structure?

Validating a modified Codex skill requires running the quick_validate.py script against the edited directory. This process checks the skill structure and metadata to ensure full compatibility with the Codex runtime before you apply the changes.

How do I regenerate agents/openai.yaml after editing skill metadata?

Regenerate agents/openai.yaml by executing the generate_openai_yaml.py script after your edits. This refreshes the UI metadata file to accurately reflect the updated skill definitions, ensuring the runtime recognizes your modified configurations.

Does the Codex skill updater work with both standard and system skills?

Yes, the Codex skill updater works with both standard and system skills. It applies to skill directories stored under $CODEX_HOME/Skills or $CODEX_HOME/skills/.system, allowing you to update and validate either location.

Do I need Python to update and refresh installed Codex skills?

Yes, you need Python to update and refresh installed Codex skills. The updater relies on local Python scripts like backup_skill.py and refresh_skill_metadata.py to manipulate files and regenerate the required YAML configurations.