comparison-table-generator_skill

Overview

This skill generates complete interactive comparison table MicroSims for educational content. It produces a ready-to-publish package (HTML, CSS, logos folder, index.md, metadata.json) and updates mkdocs.yml navigation so the new MicroSim appears in your site.

How this skill works

Provide the table title, kebab-case MicroSim name, 3–8 items (name, logo filename, short tooltip), 1–4 rating columns (1–5 stars), optional difficulty/category badges, and description column text. The skill fills templates for main.html and style.css, creates Dublin Core metadata.json, writes index.md documentation, adds logo files, and inserts the new entry into mkdocs.yml under the Simulations section.

When to use it

• Comparing programming languages, frameworks, or tools side-by-side for students
• Creating decision aids with multiple rated criteria and visual indicators
• Publishing interactive comparison tables with hover tooltips for context
• Preparing learning resources that require consistent documentation and metadata
• Rapidly producing a MicroSim package ready for mkdocs preview

Best practices

• Limit tooltips to ~200 characters for readability
• Use consistent 32x32px SVG logos to avoid row-height shifts
• Keep 3–8 items to maintain responsive layout and iframe height
• Choose semantic star colors and ensure contrast for accessibility
• Provide Dublin Core fields (creator, date, subjects) for discoverability

Example use cases

• A course page comparing Linux distributions with ratings for stability, ease-of-use, and community support
• A module comparing JavaScript frameworks with difficulty badges and use-case descriptions
• A student-facing decision chart showing cloud providers across cost, performance, and support
• An instructor resource illustrating trade-offs between algorithms with hover tooltips for nuance
• A documentation section that needs a consistent Microsim-format comparison with metadata