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.