Skills UI: frontmatter JSON field is unlabeled and not human-friendly
Resolved 💬 2 comments Opened Apr 25, 2026 by noematicsllc Closed Apr 25, 2026
Problem
When creating or editing a skill in the Claude Code UI, there's a "frontmatter" field that takes raw JSON. Two issues:
- It's not clear what it's for. There's no inline help, example, or link explaining what frontmatter does, what keys are valid, or how it affects skill behavior. A user encountering this field for the first time has no way to know whether to fill it in, leave it blank, or what shape the JSON should take.
- Raw JSON is a bad input format for humans. Even if the underlying storage/API is JSON, the UI should not require users to hand-edit JSON syntax — quoting keys, balancing braces, escaping strings. This is error-prone and unfriendly compared to a structured form (one row per key/value, dropdowns for known fields, etc.).
Suggestions
- Replace the JSON textarea with a structured editor: known frontmatter keys (
name,description, etc.) get dedicated labeled inputs; unknown keys can still be added as ad-hoc rows. - Add a tooltip/help link explaining what frontmatter is and what fields are recognized.
- If keeping the raw JSON view as an "advanced" option, default to the structured form.
Impact
Lower friction for authoring skills, fewer malformed-JSON errors, more discoverable feature.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗