Detect and fix box-drawing alignment issues in markdown ASCII-art diagrams.
npx skills add https://github.com/irrit-us/agent_misc --skill box-align-irrit-us
Please help me install this Agent Skill. Skill: box-align Source: https://github.com/irrit-us/agent_misc/tree/main/skills/box-align Command: npx skills add https://github.com/irrit-us/agent_misc --skill box-align-irrit-us
High-intent search queries and answers about installing and using this skill.
Run python3 scripts/box_align.py followed by one or more markdown file paths. The tool scans fenced code blocks containing box-drawing characters and reports nine types of alignment issues, exiting with code 1 if any are found.
Run the script with the --fix flag, for example python3 scripts/box_align.py --fix file.md. It applies corrections iteratively up to five passes, extending borders, shifting arrows through whitespace, and centering headers in place.
Yes, use the --check --quiet flags for CI mode, which suppresses detailed output and communicates results only through the exit code. Exit code 1 indicates alignment issues were found, making it suitable for pre-commit hooks and build gates.
Only fenced code blocks are checked, and T-junction and connector-column issues are detection-only with no auto-fix. Arrows that are part of a vertical connector chain are skipped to avoid breaking the chain, and width fixes extend narrower boxes to match the widest in the group.
Yes, tree-structure characters such as ├, ┤, and └ used in directory listings are correctly ignored. The box detector distinguishes tree branches from box corners by requiring adjacent horizontal border characters before treating a corner as part of a box.
miolamioBeautify and generate ASCII diagrams in markdown fenced code blocks.
felixboehmEnforce Markdown and Mermaid diagram standards for scientific documentation.
metabaseGenerate and edit Metabase documentation in Markdown and MDX formats.
pynbj1001Generate editorial hand-drawn diagrams from content prompts.
