create-issue-description

To create a translation issue description, use this skill to generate a structured file that aligns with translation issues data and TA sources. It enforces naming conventions, ensures YAML frontmatter presence, and structures guidance with required sections for downstream loading.

Updating translation issue descriptions involves modifying the existing file to reflect guideline or nomenclature changes. The skill ensures consistency across related data sources such as data/translation-issues.csv, TA articles, and TN notes during the update.

YAML frontmatter enforcement ensures translation issue description files contain required metadata headers. The skill validates frontmatter presence and enforces naming conventions so downstream loading processes can correctly parse and identify translation issue types.

Documenting a new translation issue type works best when updating related data sources like data/translation-issues.csv alongside TA articles and TN notes. The skill structures the description to align with these existing data and template sources for consistency.

The best way to structure guidance sections is to follow the required formatting enforced by the skill. It produces a structured description file with standardized sections that align with translation issues data, ensuring proper downstream loading and issue identification.