Repository navigation
docs: give the root README a full overview and gate the directory scan checks - #109
Open
chris-addison wants to merge 2 commits into
Open
chris-addison wants to merge 2 commits into
chris-addison wants to merge 2 commits into
Conversation
…n checks The Claude Code plugin directory scan wants a root README.md of at least 40 words and no angle brackets in skill descriptions. The root README was an 18-word stub, kept short on purpose because Antigravity shows it as the marketplace overview. It now describes what the skills cover in about 90 words and links to the full README in .github/, which still holds the install steps. check-skill-frontmatter.mjs now fails on angle brackets in a description and on a root README under 40 words, and the skills workflow runs when README.md changes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
chris-addison
marked this pull request as ready for review
October 29, 2026 20:13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The Claude Code plugin directory scan checks that the root README.md has at least 40 words and that no skill description contains angle brackets (like
<genre>). A failed scan holds the listing update back, and we only find out after submitting.Changes
README.md: expanded from an 18-word stub to a ~90-word overview of what the skills cover, with a link to the full README. It has no install steps, so Antigravity's marketplace overview (which renders the root README) stays short. The full README stays in.github/README.md.scripts/check-skill-frontmatter.mjs: also fails on angle brackets in a skill description (checked on the parsed YAML, sodescription: >-is fine) and on a root README that is missing or under 40 words.validate-skills.yml: runs whenREADME.mdchanges.How to test
node scripts/check-skill-frontmatter.mjs skillspasses on this branch (32 skills). With the old stub README and<genre>added to theuidescription, it reports both problems and exits 1.🤖 Generated with Claude Code