article-format-adjustment
Adjust academic paper formatting and convert between DOCX/LaTeX/Markdown when you need to meet a journal or school template requirement.
Install / Use
npx skills add aipoch/medical-research-skills --skill article-format-adjustmentInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Our assessment of article-format-adjustment
article-format-adjustment scores 92/100 on our quality scale, 293rd of 1,153 Content & Media skills we index (top 26%).
Its SKILL.md is 9.5 KB long, well organised into 26 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
With 1,916 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so article-format-adjustment is actively maintained.
- Our last check on 2026-10-27 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
article-format-adjustment compared with similar skills
All 4 of these similar skills score higher than article-format-adjustment; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| article-format-adjustment (this skill)by aipoch | 92 | 1.9k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install article-format-adjustment?
- Run
npx skills add aipoch/medical-research-skills --skill article-format-adjustment. The install tabs above show the steps for each supported agent. - Which AI agents does article-format-adjustment work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is article-format-adjustment safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is article-format-adjustment still maintained?
- The repository was last updated about 2 months ago, so article-format-adjustment is actively maintained.
Skill content
View source on GitHubname: article-format-adjustment description: Adjust academic paper formatting and convert between DOCX/LaTeX/Markdown when you need to meet a journal or school template requirement. license: MIT author: AIPOCH
Validation Shortcut
Run this minimal command first to verify the supported execution path:
python scripts/format_adjuster.py --help
When to Use
- You have a draft in Word/LaTeX/Markdown and must submit it in a different format (e.g., DOCX → LaTeX).
- A journal or school requires strict typography rules (fonts, sizes, margins, spacing) and you want them applied automatically.
- You need to enforce consistent figure/table captions and table border styles across the whole manuscript.
- You must switch or standardize citation/reference styles (e.g., IEEE, APA, GB/T 7714) before submission.
- You want to apply a known journal template (e.g., Nature/Science/Elsevier) or a custom JSON/YAML template to multiple papers.
Key Features
-
Format conversion
- Word (
.docx) ↔ Markdown (.md) - Word (
.docx) ↔ LaTeX (.tex) (via Pandoc) - Markdown (
.md) ↔ LaTeX (.tex) - Preserves document structure and basic formatting as much as possible
- Word (
-
Full formatting adjustment
- Typography: fonts, font sizes (body/headings/footnotes), line spacing, margins, paragraph indentation and spacing
- Figures/Tables: caption font size, caption position, table font, table border/line styles
- References: citation styles (APA/MLA/Chicago/IEEE/GB/T 7714), reference list formatting, in-text citation formatting
- Terminology: first-occurrence abbreviation annotation, terminology consistency checks, unit formatting standardization
-
Journal template management
- Built-in templates (e.g., Nature, Science, IEEE, Elsevier)
- Template download by journal name (best-effort from official sources/Overleaf)
- Custom templates via JSON/YAML configuration
-
Validation
- Checks whether the output meets the configured formatting requirements.
Dependencies
Runtime
- Python
>= 3.8
Python packages (typical)
python-docx(Word read/write)markdown(Markdown processing)PyYAML(YAML parsing)requests(template download)beautifulsoup4(HTML parsing)
System tools
pandoc(required for DOCX ↔ LaTeX conversions)- Windows:
choco install pandoc - macOS:
brew install pandoc - Linux (Debian/Ubuntu):
apt install pandoc
- Windows:
Note: Exact package versions depend on
requirements.txtin your repository.
Example Usage
1) Apply a built-in journal template (DOCX → formatted DOCX)
python scripts/init_run.py \
--input paper.docx \
--journal "Nature" \
--output paper_formatted.docx
2) Apply a custom configuration (MD → formatted MD)
python scripts/init_run.py \
--input paper.md \
--config formats/my_journal.json \
--output paper_adjusted.md
3) Download a journal template configuration
python scripts/init_run.py \
--download-template "Science" \
--output templates/science_format.json
4) Minimal end-to-end runnable Python example (module usage)
from scripts.format_converter import FormatConverter
from scripts.format_adjuster import FormatAdjuster
def run(input_file: str, config: dict, output_file: str):
converter = FormatConverter()
adjuster = FormatAdjuster(config)
# 1) Normalize to Markdown as an intermediate representation
md = converter.to_markdown(input_file)
# 2) Apply formatting rules
formatted_md = adjuster.apply_format(md, config)
# 3) Validate against the same rules
ok = adjuster.validate_format(formatted_md, config)
if not ok:
raise RuntimeError("Validation failed: output does not meet the configured requirements.")
# 4) Convert back to the desired output format inferred from output_file
converter.from_markdown(formatted_md, output_file)
if __name__ == "__main__":
config = {
"font": {"body": "Times New Roman", "body_size": 10},
"spacing": {"line_space": "single", "paragraph_space": 6, "indent": 0.5},
"margins": {"top": 2.54, "bottom": 2.54, "left": 2.54, "right": 2.54},
"references": {"style": "Nature", "format": "numbered"},
"figures": {"caption_position": "below", "font_size": 9},
"tables": {"caption_position": "above", "font_size": 9, "borders": True},
}
run("paper.docx", config, "paper_formatted.docx")
Implementation Details
Processing pipeline
- Detect input format (
.docx/.md/.tex) - Convert to Markdown as a unified intermediate representation
- Apply formatting rules from a selected journal template or custom config
- Validate the formatted result against the config
- Convert to target format (DOCX/MD/TEX)
Core modules (typical responsibilities)
format_converter.py- Conversion engine between Word/Markdown/LaTeX
- Uses Pandoc for conversions involving LaTeX and/or DOCX where needed
format_adjuster.py- Applies typography, figure/table, and reference formatting rules
- Provides validation routines to check compliance
template_downloader.py- Downloads template/config by journal name (best-effort)
- Parses web sources (often via
requests+beautifulsoup4)
format_validator.py- Performs rule-based checks (margins, font sizes, caption placement, citation style selection, etc.)
Configuration schema (key parameters)
A configuration file (JSON/YAML) typically includes:
fontbody,body_size,title,title_size,caption,caption_size
spacingline_space(single/1.5/double)paragraph_space(e.g., points)indent(e.g., first-line indent)
marginstop,bottom,left,right(commonly in cm)
referencesstyle(e.g.,IEEE,APA,GB/T 7714-2015)format(e.g.,numbered,author-year)
figures/tablescaption_position(above/below)font_sizeborders(tables)
CLI parameters (behavior)
--input: input file path (required)--output: output file path (auto-generated if omitted)--config: path to JSON/YAML config (uses built-in default if omitted)--journal: journal name (selects a built-in or downloaded template)--download-template: journal name to download a template config--format: output format (docx/md/tex), defaults to the input format
When Not to Use
- Do not use this skill when the required source data, identifiers, files, or credentials are missing.
- Do not use this skill when the user asks for fabricated results, unsupported claims, or out-of-scope conclusions.
- Do not use this skill when a simpler direct answer is more appropriate than the documented workflow.
Required Inputs
- A clearly specified task goal aligned with the documented scope.
- All required files, identifiers, parameters, or environment variables before execution.
- Any domain constraints, formatting requirements, and expected output destination if applicable.
Recommended Workflow
- Validate the request against the skill boundary and confirm all required inputs are present.
- Select the documented execution path and prefer the simplest supported command or procedure.
- Produce the expected output using the documented file format, schema, or narrative structure.
- Run a final validation pass for completeness, consistency, and safety before returning the result.
Output Contract
- Return a structured deliverable that is directly usable without reformatting.
- If a file is produced, prefer a deterministic output name such as
article_format_adjustment_result.mdunless the skill documentation defines a better convention. - Include a short validation summary describing what was checked, what assumptions were made, and any remaining limitations.
Validation and Safety Rules
- Validate required inputs before execution and stop early when mandatory fields or files are missing.
- Do not fabricate measurements, references, findings, or conclusions that are not supported by the provided source material.
- Emit a clear warning when credentials, privacy constraints, safety boundaries, or unsupported requests affect the result.
- Keep the output safe, reproducible, and within the documented scope at all times.
Failure Handling
- If validation fails, explain the exact missing field, file, or parameter and show the minimum fix required.
- If an external dependency or script fails, surface the command path, likely cause, and the next recovery step.
- If partial output is returned, label it clearly and identify which checks could not be completed.
Quick Validation
Run this minimal verification path before full execution when possible:
python scripts/format_adjuster.py --help
Expected output format:
Result file: article_format_adjustment_result.md
Validation summary: PASS/FAIL with brief notes
Assumptions: explicit list if any
Deterministic Output Rules
- Use the same section order for every supported request of this skill.
- Keep output field names stable and do not rename documented keys across examples.
- If a value is unavailable, emit an explicit placeholder instead of omitting the field.
Completion Checklist
- Confirm all required inputs were present and valid.
- Confirm the supported execution path completed without unresolved errors.
- Confirm the final deliverable matches the documented format exactly.
- Confirm assumptions, limitations, and warnings are surfaced explicitly.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
