Skip to content

fix: rewrite share.md as a command template with YAML frontmatter#44

Open
xiaolai wants to merge 1 commit intonicobailon:mainfrom
xiaolai:fix/nlpm-share-command-frontmatter
Open

fix: rewrite share.md as a command template with YAML frontmatter#44
xiaolai wants to merge 1 commit intonicobailon:mainfrom
xiaolai:fix/nlpm-share-command-frontmatter

Conversation

@xiaolai
Copy link
Copy Markdown

@xiaolai xiaolai commented Apr 26, 2026

Automated audit: This PR was generated by NLPM, a natural language programming linter, running via claude-code-action. Please evaluate the diff on its merits.

What's wrong

commands/share.md is formatted as README documentation — markdown headers (## Usage, ## How It Works, ## Requirements, etc.), code fences, and prose sections — rather than a command template. Every other command in the plugin uses a minimal YAML frontmatter block (name: + description:) followed by a prompt body. Because share.md has no frontmatter at all, it lacks both the name and description fields required for command registration, and Claude Code may not register it as a command.

The fix

Rewrote share.md as a proper command template following the same convention as the other seven commands:

  • Added name: share and description: Share a visual explainer HTML page via Vercel and return a live URL as YAML frontmatter
  • Replaced the README-style body with a concise prompt that instructs the agent to run share.sh and display the result
  • Preserved the key functional detail: if no argument is provided, list available HTML files and ask the user to select one
  • Preserved the public-deployment disclosure note inline in the prompt

The documentation content (script location, output format, requirements) is already described well in SKILL.md and in the script itself, so nothing of substance is lost.

share.md was formatted as README documentation (markdown headers, code
fences, usage sections) rather than a command template. Without YAML
frontmatter containing name and description fields, the command will
not register correctly in Claude Code.

Rewritten as a minimal prompt template matching the convention used by
every other command in the plugin.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant