Plugin fails to load in Claude Code: SKILL.md frontmatter missing `name:` field and contains duplicate `---` separators

[peddy76]

Summary

The us-stock-analysis plugin (marketplace invest-skill) fails to load in Claude Code with the error:

us-stock-analysis  Plugin · invest-skill · ✘ failed to load · 1 error

Root cause: every SKILL.md in plugins/us-stock-analysis/skills/*/ has malformed YAML frontmatter — the required name: field is
missing, and the file contains a duplicate --- separator producing an empty leading frontmatter block.

Reproduction

1. Add the marketplace and install the plugin in Claude Code:

   /plugin marketplace add yennanliu/InvestSkill
   /plugin install us-stock-analysis@invest-skill
   

2. Run /plugin list → plugin is reported as failed to load.
3. None of the 21 skills (stock-eval, dcf-valuation, chart-master, …) become available.

Tested on Claude Code (CLI), macOS, plugin version 1.6.0.

Current state (broken)

plugins/us-stock-analysis/skills/stock-eval/SKILL.md (and all 20 other skill files) starts with:

---
---
description: Evaluate US stocks with comprehensive fundamental and valuation analysis
---

Two issues here:

1. Duplicate --- separators: there is an empty frontmatter block followed by a second block. Most YAML parsers either reject this or
   interpret the file as having no frontmatter.
2. Missing name: field: Claude Code's skill loader requires both name: and description:. Working skill plugins (e.g.
   ansible-skills, Anthropic's superpowers) include both:

   ---
   name: ansible-convert
   description: Use when converting shell scripts to Ansible playbooks ...
   ---

Expected fix

For each of the 21 SKILL.md files under plugins/us-stock-analysis/skills/<skill-name>/SKILL.md, the frontmatter should be:

---
name: <skill-name>
description: <existing description>
---

where <skill-name> matches the parent directory name (stock-eval, dcf-valuation, chart-master, competitor-analysis,
dividend-analysis, earnings-call-analysis, economics-analysis, financial-report-analyst, full-report, fundamental-analysis,
insider-trading, institutional-ownership, options-analysis, portfolio-review, report-generator, research-bundle,
result-validator, sector-analysis, short-interest, stock-valuation, technical-analysis).

Suggested follow-up

The PR template checklist currently says:

- [ ] SKILL.md files have proper frontmatter with description

Recommend updating to:

- [ ] SKILL.md files have proper frontmatter with `name:` and `description:` (single `---` block)

so future skills don't reintroduce the issue.

Happy to send a PR with the fix if useful.

[github-actions]

👋 Thanks for opening your first issue in InvestSkill!

We appreciate your interest in improving this project. A maintainer will review your issue and respond as soon as possible.

In the meantime, please make sure you've provided:

• A clear description of the issue
• Steps to reproduce (if it's a bug)
• Your Claude Code version and OS

Feel free to check out our Contributing Guide if you'd like to help with a fix!