Figure Description Skills Package

Standardized accessibility descriptions and verified analysis for electronic, hydraulic, and pneumatic schematics.

Install
cmdop skills install agensi-figure-description-skills-package

The Figure Description Skills Package is a skill designed for developers and educators building accessible study guides and technical documentation. It addresses the challenge of producing screen-reader-compatible descriptions for complex visual content, including electronic schematics and hydraulic and pneumatic diagrams.

The package contains four specialized modules. The figure description module generates standards-compliant accessibility text focused on educational outcomes for visually impaired students, withholding answers while preserving all given values so students can still work through problems independently. The automated docx workflow module handles programmatic insertion of descriptions into .docx files by unpacking the underlying XML, verifying image order, and repacking the document. The specialized schematics module applies domain-specific rules to hydraulic and pneumatic diagrams to ensure functional topology is accurately conveyed. The verified circuit analysis module enforces a check-then-calculate workflow that validates component specifications — such as Early voltage or transformer turns ratios — against datasheet facts before performing output impedance or power analysis.

Output follows a structured, bold-labeled format (e.g., Figure 1. followed by description text), or produces technical analysis reports that cite verified datasheets and identify specific circuit revisions such as discrete versus IC-based output stages.

This skill is not appropriate for general-purpose image captioning, non-technical visual content, or workflows that do not involve .docx files or schematic-based figures.

Use cases

  • Generate screen-reader-compatible descriptions for electronic schematics in study guides
  • Automate insertion of accessibility text into .docx technical documents via XML manipulation
  • Produce domain-correct descriptions for hydraulic and pneumatic system diagrams
  • Verify electronic component specifications against datasheet values before circuit analysis
  • Create structured figure descriptions that preserve problem-solving opportunity for visually impaired students
  • Generate technical analysis reports for amplifier topologies citing specific circuit revisions

When to use it

  • Building accessible study guides for visually impaired students covering technical diagrams
  • Automating accessibility description workflows for .docx-format documentation
  • Describing hydraulic or pneumatic schematics where functional topology must be correctly conveyed
  • Performing verified analysis of electronic circuits where component specs must be validated before calculation

When not to use it

  • Describing non-technical or photographic visual content not covered by the four specialized modules
  • Working with document formats other than .docx
  • Projects requiring a general-purpose image captioning tool without pedagogical or engineering constraints
  • Workflows where no schematic, circuit, or technical diagram is involved