Fix #3: JSON blocks could benefit from inline annotations

[RichardHightower]

Fix #3: JSON blocks could benefit from inline annotations

Severity: Low | Pillar: Writing Style | Impact: +1 point

Problem

Large JSON policy blocks lack inline comments explaining key fields

Location

SKILL.md:common patterns, references/*.md

Current Code

Raw JSON with explanatory text before/after but not inline

Suggested Fix

Add # comments within JSON (where supported) or JSONC format snippets for educational value

---

Part of Skill Grading Report

Powered by: SkillzWave.ai | SpillWave