skills.rest
emilianoeloi
emilianoeloiCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

readme-manutencao

Synchronize project README files across Portuguese, English, and Chinese versions.

6|Updated Feb 25, 2026
Search Tags:#documentation#markdown#github#synchronization#translation#readme#multilingual
One-click install
npx skills add https://github.com/emilianoeloi/cowboy --skill readme-manutencao-emilianoeloi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: readme-manutencao
Source: https://github.com/emilianoeloi/cowboy/tree/main/.github/skills/readme-manutencao
Command: npx skills add https://github.com/emilianoeloi/cowboy --skill readme-manutencao-emilianoeloi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping multiple translated README files consistent is tedious and error-prone. This Skill maintains three synchronized READMEs (PT-BR, EN, ZH) so documentation never drifts out of sync with the actual project code or between language versions. ## Core Features & Use Cases - Multi-language synchronization: Updates README.md, README-en.md, and README-zh.md together with consistent content, badges, and cross-language navigation links. - Code example verification: Compares COBOL code blocks in the READMEs against the real source in src/CALCULADORA.cbl and updates outdated snippets. - Translation rules: Applies defined tone and terminology guidelines when translating from Portuguese to English and Chinese. - Use Case: After adding a new operation to the COBOL calculator, run this Skill to update the feature list and code examples in all three READMEs at once. ## Quick Start Update all three project READMEs to reflect the current state of src/CALCULADORA.cbl and keep the translations synchronized.

Frequently Asked Questions about readme-manutencao

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

FAQPage Schema
How do I keep translated README files synchronized?▼

Update the primary README first, then propagate the same changes to each translated version while adapting tone and terminology per language. This Skill defines explicit translation rules and a quality checklist to keep PT-BR, EN, and ZH versions aligned.

How to update README code examples after source code changes?▼

Read the actual source file, identify all code blocks in the READMEs, and compare variable names, paragraph names, and operations against the real code. Replace outdated snippets with real excerpts from the source rather than inventing generic examples.

When should I run README maintenance on a project?▼

Run it after adding new features, creating new agents or prompts, changing the project structure, or whenever the README no longer reflects the current code. It is also triggered when a user asks to update the documentation.

What are the limitations of automated README translation?▼

Literal translation often breaks tone and cultural context, so this Skill uses adaptation rules instead of word-for-word conversion. Content must still be reviewed per language to ensure no untranslated fragments remain in the English or Chinese versions.

Related Skills

Explore More Content & Communication Skills→
sorafujitanisorafujitani
1

plan:dry-coding

Plan code implementations with structured steps and file templates.

Community
Advanced
mhamzahashimmhamzahashim

doc-maintenance

Audit top-level documentation for drift and open Pull Requests with proposed edits.

Community
Advanced
PracticalSwanPracticalSwan
7

documentation-verification

Validate documentation completeness, broken links, and code example accuracy.

Community
Intermediate
mscipiomscipio

doc-generator

Generate README, API, and CLI documentation from source code comments.

Community
Advanced