# xf-parse-index

> Regenerate xf-design-system/component-index.json from xf-design-system/component-index.md. Use when component-index.md changes, when JSON is missing or stale, or when verifying component index schema during design-system updates.

- Author: wzywg
- Repository: wzywg/x-fader-ds
- Version: 20260129123448
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/wzywg/x-fader-ds
- Web: https://mule.run/skillshub/@@wzywg/x-fader-ds~xf-parse-index:20260129123448

---

---
name: xf-parse-index
description: Regenerate xf-design-system/component-index.json from xf-design-system/component-index.md. Use when component-index.md changes, when JSON is missing or stale, or when verifying component index schema during design-system updates.
---

## When to use
- Component index markdown has been updated
- JSON is missing, outdated, or corrupted
- Validating component index structure
- New components added to component-index.md

## When NOT to use
- You're making one-off JSON edits (edit component-index.json directly)
- You need to add new components (add to component-index.md first)

## Inputs
- Source markdown file (defaults to `xf-design-system/component-index.md`)
- Output JSON file (defaults to `xf-design-system/component-index.json`)

## Steps

### 1) Verify markdown source
- Confirm `xf-design-system/component-index.md` exists and is current
- Check for proper markdown formatting and component entries

### 2) Parse and generate JSON
- Run parsing script to convert markdown to structured JSON
- Verify component entries are correctly extracted
- Check Figma links and node IDs are properly formatted

### 3) Validate output
- Review generated `xf-design-system/component-index.json` structure
- Spot-check component names and metadata
- Verify Figma node IDs are extractable

### 4) Test integration
- Confirm JSON can be loaded by tools and scripts
- Check component references resolve correctly
- Verify Figma MCP can access to node IDs

## Output
- Updated `xf-design-system/component-index.json` with current component data
- Validation report of any parsing issues
- Component count and summary statistics

## Troubleshooting
- Missing components: Check markdown formatting and component entries
- Invalid JSON: Verify markdown syntax and parsing logic
- Broken Figma links: Check URL format and node ID extraction
- MCP errors: Verify node IDs are valid and accessible