restapi-translations

Official

Automate REST API translation sync.

Authormikopbx
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Manually managing 1500+ REST API translation keys across numerous PHP files is error-prone and time-consuming, leading to missing or unused keys in RestApi.php. This Skill automates the entire translation key lifecycle, ensuring your API documentation is always accurate and complete.

Core Features & Use Cases

  • Automated Key Extraction: Scans all PHP source code to find every rest_* translation key, eliminating manual tracking.
  • Comprehensive Validation: Identifies missing keys (present in code, absent in RestApi.php) and unused keys (present in RestApi.php, absent in code), providing a clear overview of translation status.
  • Safe Synchronization: Adds missing keys with context-aware Russian placeholders and safely removes unused keys, complete with automatic backups and PHP syntax validation to prevent errors.
  • Use Case: After adding a new REST API endpoint, simply run this skill. It will automatically extract any new translation keys, add them to RestApi.php with [ТРЕБУЕТ ПЕРЕВОДА] placeholders, and then prompt you to translate them. This ensures your API documentation is always up-to-date and ready for localization.

Quick Start

Enter interactive mode for full sync

./manage_translations.sh

Select option 7: Run all (extract + validate + sync)

Dependency Matrix

Required Modules

python3Bash

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: restapi-translations
Download link: https://github.com/mikopbx/Core/archive/main.zip#restapi-translations

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository