convert-changelog

Convert Figma changelogs into structured JSON for uSpec.

236|32|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/redongreen/uSpec --skill convert-changelog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-changelog
Source: https://github.com/redongreen/uSpec/tree/main/.cursor/skills/convert-changelog
Command: npx skills add https://github.com/redongreen/uSpec --skill convert-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the conversion of existing Figma changelogs into a structured JSON format, making them compatible with the uSpec system and easier to manage.

Core Features & Use Cases

  • Figma Integration: Connects to Figma via the Desktop Bridge to extract changelog content directly.
  • Structure Detection: Identifies whether the changelog uses a standard uSpec template or a more freeform structure.
  • Data Extraction & Parsing: Extracts dates, authors, and change details, then parses them into a consistent format.
  • Content Rewriting: Cleans up and standardizes dates, titles, and descriptions for clarity and consistency.
  • Use Case: You have a Figma file containing release notes for your design system. This Skill can convert that visual information into a machine-readable JSON file that can be used to generate documentation or populate a changelog feed.

Quick Start

Use the convert-changelog skill to convert the Figma changelog at the provided URL into structured JSON.

Frequently Asked Questions about convert-changelog

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

FAQPage Schema
How do I convert a Figma changelog into structured JSON?

You can convert Figma changelogs to JSON by providing the Figma URL to this Skill. It connects via the Desktop Bridge to extract changelog content directly, parsing dates, authors, and change items into structured JSON.

Can I extract unstructured text from a Figma file into JSON format?

Yes, this Skill handles unstructured text by detecting freeform structures within Figma files. It extracts the raw text, parses the relevant dates and change details, and rewrites them according to normalization rules to produce validated JSON.

Does converting Figma changelogs require a specific Figma connection setup?

Yes, converting Figma changelogs requires Figma's Desktop Bridge connection. This setup enables the Skill to utilize Figma's MCP for navigation, screenshotting, and content extraction directly from your design files.

What is the best way to automate design system release notes extraction?

Automating design system release notes extraction is best achieved by converting Figma changelogs into structured JSON. This Skill automatically cleans and standardizes dates, titles, and descriptions, producing a machine-readable output for documentation generation.

How does the changelog parser handle inconsistent dates and titles?

The changelog parser handles inconsistent dates and titles by cleaning up and standardizing them during extraction. It normalizes the content according to specified rules, ensuring clarity and consistency before outputting the validated JSON.