Index of every page on this site: llms.txt
All skills
masihmoafi avatar

/word-farsi-docx

@c0a5d13
by Masih Moafimasihmoafi/skills10 stars
Run it yourself

Build a clean, editable Persian (Farsi) Word .docx in B Nazanin from a report, PDF or TeX source with python-docx. Use for Persian Word output, RTL or font problems in .docx, or converting a Persian report to Word.

Use this Skill: https://skilld.dev/gh/masihmoafi/skills/word-farsi-docx

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈58 tokens for metadata: the name and description. ≈796 when used: this file.

Description uses 2.9% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈232 characters, or 2.9%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Persian Word documents

Produce a Word-native, RTL-correct Persian .docx in B Nazanin that keeps a clean academic layout.

Goal

  • Real Word objects (paragraphs, tables, images), not PDF pages pasted into Word.
  • The template's margins, spacing and headings preserved.
  • RTL punctuation and alignment correct.
  • B Nazanin everywhere, including English inside Persian text.
  • Tables, bullets, headings, page breaks and images supported.

Tools

  • python-docx for generation and styling.
  • Optionally, PDF text extraction or page images as a reference; rebuild the content as Word objects.
  • For validation, render the final document with a Word-compatible renderer and compare its pages with the reference. If no renderer is available, report the visual check as incomplete.

Steps

  1. Start from the bundled template perfect-farsi-word.docx in this skill's folder, which already has the right margins, spacing and headings, because styling Word from scratch is fragile.
  2. Clear the body but keep w:sectPr, which holds page size, margins and layout; deleting it changes the page geometry.
  3. Set every paragraph to right alignment and add w:bidi = 1, since Persian can look right while punctuation, numbering and Latin tokens behave wrongly without the RTL flag.
  4. Set B Nazanin on every run in all four w:rFonts channels (w:ascii, w:hAnsi, w:cs, w:eastAsia) and in run.font.name, because mixed-script runs fall back to other fonts unless all channels are set.
  5. Rebuild the content as Word structures: headings, normal paragraphs, bullet and numbered lists, Table Grid tables and captioned images, so the document stays editable and its layout consistent.
  6. Set w:spacing explicitly on key paragraphs and headings (for example after = 120), since Word's defaults inflate spacing around Persian text.
  7. Build tables with doc.add_table, bold the header row and apply RTL and B Nazanin to every cell paragraph and run, because tables show direction and font bugs first.
  8. Insert doc.add_page_break() after the cover, after the abstract and between major sections so Word does not reflow them unpredictably.
  9. After all content is added, walk every paragraph and run and reapply RTL and B Nazanin, keeping centred cover paragraphs centred, because some operations add runs with default fonts or drop the bidi flag.
  10. If the client cannot download Persian filenames, also save an ASCII-named copy and optionally a .zip.

Quality checklist

  • Persian punctuation (، ؛ ؟) is correct and stays RTL.
  • English terms sit in parentheses and do not break the sentence flow.
  • No empty placeholder squares.
  • Headings are bold and consistently sized.
  • Bullets align correctly in RTL.
  • Tables are readable, aligned and do not overflow.
  • Images are undistorted and captioned.
  • Page breaks fall where intended.

Failures and fixes

Symptom Fix
Wrong font Set w:rFonts in all four channels
RTL looks right but punctuation is wrong Add w:bidi = 1 to the paragraph properties
Layout changed after editing sectPr was removed; keep it
Download fails Save an ASCII-named copy or zip it

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts23d3 checks · Risk SAFE
  • Gen Agent Trust Hub23d

    The skill is safe. It provides instructions for generating Persian (Farsi) Word documents using the python-docx library, specifically addressing Right-to-Left (RTL) formatting and font styling.

  • Socket23d

    No alerts

  • Snyk23d

    Risk: LOW · No issues

Signed by skilld at c0a5d13. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 3 weeks ago

README badge

README badge for masihmoafi/skills/word-farsi-docx