microsims-index-generator

Generate and update MicroSims grid index pages for MkDocs Material.

90|12|Updated Nov 1, 2025
Search Tags:#index#grid#sims
One-click install
npx skills add https://github.com/dmccreary/claude-skills --skill microsims-index-generator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: microsims-index-generator
Source: https://github.com/dmccreary/claude-skills/tree/main/skills/archived/microsims-index-generator
Command: npx skills add https://github.com/dmccreary/claude-skills --skill microsims-index-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill generates and updates a grid-style index page for MicroSims, captures missing screenshots, and integrates navigation with MkDocs.

Core Features & Use Cases

  • Scans /docs/sims and builds a grid-card index
  • Automatically captures missing screenshots
  • Updates mkdocs.yml navigation with new simulators

Quick Start

Generate the index and ensure each MicroSim has a preview image.

Frequently Asked Questions about microsims-index-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a grid-card index page for MicroSims in MkDocs?▼

This Skill automates grid-card index generation by scanning your /docs/sims directory, capturing missing screenshots, and producing alphabetically sorted cards in mkdocs-material format. It requires MkDocs with Material theme, attr_list and md_in_html extensions, and a screenshot tool at ~/.local/bin/bk-capture-screenshot.

Can I automatically capture screenshots for my MicroSims?▼

Yes. The Skill detects missing preview images and runs bk-capture-screenshot to generate them automatically, provided each MicroSim contains main.html and index.md in /docs/sims.

Does this work with MkDocs Material projects?▼

This Skill is designed specifically for MkDocs Material projects. It requires the Material theme, attr_list and md_in_html extensions, and generates grid cards in Material-compatible format with automatic navigation synchronization in mkdocs.yml.

What happens when I add new MicroSims to my documentation?▼

The Skill scans for new simulators in /docs/sims, captures their screenshots if missing, adds them to the alphabetically sorted grid index, and updates your mkdocs.yml navigation automatically.

What are the prerequisites for running this Skill?▼

You need MkDocs with Material theme installed, extensions attr_list and md_in_html enabled, MicroSims structured with main.html and index.md files under /docs/sims, and the bk-capture-screenshot tool available at ~/.local/bin/bk-capture-screenshot.

Can I reformat an existing MicroSims index with this Skill?▼

Yes. The Skill regenerates grid cards and reformats navigation whenever previews are missing or the index needs restructuring, maintaining alphabetical order and Material theme compliance.