library-sync
Sync and manage bilingual (EN/RU) library content for agency-docs. Use when adding, updating, or reviewing library articles. Handles translation, sync checks, and Russian stylistic review.
How do I install this agent skill?
npx skills add https://github.com/glebis/claude-skills --skill library-syncIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The library-sync skill is a benign administrative utility for managing bilingual documentation in a local project. It performs standard file operations to synchronize and review English and Russian articles. No security risks or malicious patterns were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Library Sync Skill
Manages the bilingual library at ~/Sites/agency-docs/content/docs/library/ with English (en/) and Russian (ru/) versions.
Commands
add <slug> — Add a new article to both languages
- Create the article in English first at
content/docs/library/en/<slug>.mdx - Translate to Russian at
content/docs/library/ru/<slug>.mdx - Add to both
meta.jsonfiles in the appropriate section - Run Russian stylistic review
- Verify both render correctly
sync — Check sync status between EN and RU
- List all files in
en/andru/ - Report files missing in either language
- Compare frontmatter titles (ensure they match conceptually)
- Flag articles updated in one language but not the other (compare git timestamps)
translate <slug> <from> <to> — Translate an article
- Read the source article
- Translate to target language
- Adapt examples and links for the target audience
- Run stylistic review if target is Russian
- Update meta.json
review-ru — Russian stylistic review
Run on all Russian library articles. Check for:
- Consistency: same terms used throughout (not mixing Агент/Эйджент)
- Natural Russian: not word-for-word translation from English
- Technical terms: keep English terms where standard (Git, MCP, API, CLAUDE.md)
- Links: internal links use
/library/ru/paths - Tone: educational but not condescending, informal "ты" address
update <slug> — Update an existing article in both languages
- Read the current version
- Apply changes to the primary language
- Sync changes to the other language
- Run Russian review if Russian was changed
File Structure
content/docs/library/
├── index.mdx # Landing page
├── meta.json # Top-level nav (separators + language folders)
├── en/
│ ├── meta.json # English article order with section separators
│ └── *.mdx # English articles
└── ru/
├── meta.json # Russian article order with section separators
└── *.mdx # Russian articles
Russian Style Guide
- Use "ты" (informal), not "вы" (formal)
- Keep technical terms in English: Git, API, MCP, CLAUDE.md, CLI, LLM, token
- Transliterate only when a Russian term is well-established: агент, промт, токен
- Don't translate code examples or command-line output
- Adapt cultural references (e.g., currency examples: use both $ and ₽)
- Cross-link to English version at the bottom:
[English version](/library/en/<slug>) - Cross-link from English to Russian:
[Русская версия](/library/ru/<slug>)
Meta.json Sections
Use ---SectionName--- separators in meta.json for nav grouping:
- Modes / Режимы
- Core Concepts / Ключевые концепции
- Features / Возможности
- Tools / Инструменты
- Reference / Справочник
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/glebis/claude-skills/library-sync">View library-sync on skillZs</a>