147 Generated Ef3a1f5f

# MicroSim Quality Report

**Generated**: 2025-11-22 13:06:50

## Summary Statistics

- **Total MicroSims**: 29
- **Average Quality Score**: 85.7/100

### Quality Distribution

| Category | Count | Percentage |
|----------|-------|------------|
| 🏆 Perfect (100) | 9 | 31.0% |
| ✓ Excellent (90-99) | 0 | 0.0% |
| ✓ Good (85-89) | 0 | 0.0% |
| ○ Fair (70-84) | 20 | 69.0% |
| ✗ Needs Work (<70) | 0 | 0.0% |

## Detailed Quality Report

| MicroSim Name | Score | Library | Improvement Notes |
|---------------|-------|---------|-------------------|
| 🏆 average-dependencies-distribution | 100/100 | Chart.js |  |
| 🏆 chapter-content-generation-timeline | 100/100 | HTML/CSS/JS |  |
| 🏆 microsim-file-relationship-diagram | 100/100 | p5.js |  |
| 🏆 mkdocs-github-pages-deployment | 100/100 | Mermaid |  |
| 🏆 orphaned-nodes-identification | 100/100 | Chart.js |  |
| 🏆 sine-function-plot | 100/100 | Plotly.js |  |
| 🏆 skill-context-window | 100/100 | p5.js |  |
| 🏆 taxonomy-distribution-pie | 100/100 | Chart.js |  |
| 🏆 test-world-cities | 100/100 | Leaflet |  |
| ○ adding-taxonomy-workflow | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ book-levels | 80/100 | p5.js | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: Copy-paste iframe example in HTML code block (+5 pts), References section with links (+5 pts) |
| ○ chapter-index-structure | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ chapter-organization-workflow | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ concept-length-histogram | 80/100 | Chart.js | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ course-description-quality-workflow | 80/100 | p5.js | **Critical**: **iframe element with src="main.html"** (+10 pts), **Comprehensive lesson plan** (+10 pts); **Important**: Copy-paste iframe example in HTML code block (+5 pts), References section with links (+5 pts), Library-specific documentation (e.g., p5.js editor link) (+5 pts) |
| ○ dag-validation-algorithm | 80/100 | vis-network | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ faq-pattern-analysis | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ git-workflow-skill-development | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ graph-viewer | 80/100 | vis-network | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ learning-graph-json-schema | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ linear-chain-vs-network | 80/100 | vis-network | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ mkdocs-build-process | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ p5js-architecture | 80/100 | p5.js | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts), Library-specific documentation (e.g., p5.js editor link) (+5 pts) |
| ○ security-zones-diagram | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ skill-directory-structure | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ skill-installation-workflow | 80/100 | HTML/CSS/JS | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ terminal-workflow-textbook | 80/100 | Mermaid | **Critical**: **Comprehensive lesson plan** (+10 pts); **Important**: References section with links (+5 pts) |
| ○ claude-code-timeline | 75/100 | HTML/CSS/JS | **Critical**: **iframe element with src="main.html"** (+10 pts), **Comprehensive lesson plan** (+10 pts) |
| ○ skill-impact-chart | 70/100 | Chart.js | **Critical**: **iframe element with src="main.html"** (+10 pts), **Comprehensive lesson plan** (+10 pts); **Important**: Copy-paste iframe example in HTML code block (+5 pts) |

## Recommendations

### Quick Wins

### Lesson Plans Needed (20 MicroSims)

Adding lesson plans (+10 points each) would significantly improve quality:

- **adding-taxonomy-workflow**: 80 → 90/100
- **book-levels**: 80 → 90/100
- **chapter-index-structure**: 80 → 90/100
- **chapter-organization-workflow**: 80 → 90/100
- **concept-length-histogram**: 80 → 90/100
- _(and 15 more)_

## Quality Rubric Reference

| Element | Points | Description |
|---------|--------|-------------|
| Title | 2 | Level 1 markdown header |
| Main Html | 10 | main.html file exists |
| Yaml Metadata | 3 | YAML frontmatter with title and description |
| Image Metadata | 5 | Image metadata for social preview (image: and og:image) |
| Metadata Json | 10 | metadata.json file exists |
| Metadata Valid | 20 | metadata.json passes Dublin Core schema validation |
| Iframe | 10 | iframe element with src="main.html" |
| Fullscreen Button | 5 | Fullscreen link button |
| Iframe Example | 5 | Copy-paste iframe example in HTML code block |
| Image File | 5 | PNG screenshot file exists |
| Overview | 5 | Overview/Description section |
| Lesson Plan | 10 | Comprehensive lesson plan |
| References | 5 | References section with links |
| Type Specific | 5 | Library-specific documentation (e.g., p5.js editor link) |

**Total Possible Score**: 100 points

---

*This report was automatically generated by the `bk-microsim-quality-report-generator` script.*