figure-reference-checker

What This Skill Does

The figure-reference-checker is a specialized tool designed for academic researchers and technical writers to maintain document integrity. It systematically scans manuscript files—specifically supporting formats like .docx—to cross-reference in-text citations with actual image captions. By parsing the document structure, the skill ensures that every time a reference like 'see Figure 1' appears, a corresponding figure label exists. It effectively flags orphaned references that point to non-existent figures, alerts users to potential inconsistencies in numbering, and highlights missing citations where figures may have been inserted but not referenced. This process ensures that your manuscript remains logically coherent and ready for professional peer review.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal: clawhub install openclaw/skills/skills/aipoch-ai/figure-reference-checker Ensure your local environment meets the standard prerequisites for OpenClaw tools and that you have sufficient permissions in your working directory to allow the tool to read your manuscript files and generate audit reports.

Use Cases

This skill is ideal for:

• Academic manuscript preparation to ensure compliance with journal formatting standards.
• Technical documentation cleanup where multiple authors may have inadvertently duplicated or deleted figure labels.
• Final pre-submission quality assurance checks for theses, dissertations, or whitepapers.
• Rapid auditing of large documents (50+ pages) where manual verification is prone to human error.

Example Prompts

1. 'Please scan my paper.docx and identify any orphaned figure references that don't match an actual figure label.'
2. 'Run the figure-reference-checker on draft_v4.docx and list all missing citations for my illustrations.'
3. 'Check the consistency of figure numbering in thesis_final.docx to ensure no figures are skipped or referenced incorrectly.'

Tips & Limitations

• Input Validation: Ensure your manuscript is saved in a standard .docx format for the best parsing results.
• File Paths: Always provide the full or relative path to your file in the workspace to avoid traversal errors.
• Limitations: Currently, this tool does not support complex LaTeX files or multi-document projects linked via cross-reference managers. It is optimized for standalone document processing. Ensure your document is closed in other editors (like MS Word) before running the checker to avoid file-locking issues.