Back to articles
Marketplace Quality Blitz: 130 Stub Files, 4300 Warnings, Zero Excuses

Marketplace Quality Blitz: 130 Stub Files, 4300 Warnings, Zero Excuses

via Dev.to WebdevJeremy Longshore

130 plugins had SKILL.md files that said nothing. Not bad documentation. Not incomplete documentation. Template stubs. Copy-pasted boilerplate with placeholder text where the actual content should be. A user opening one of these files learned exactly two things: that the file existed and that nobody had bothered to fill it in. This week I replaced all 130 of them. The Stub Problem When you scaffold a plugin, the generator creates a SKILL.md. That's good practice. But when you scaffold 340 plugins over several months, some of those files never graduate from template to documentation. They sit there with [Describe your skill here] blocks, passing existence checks while providing zero value. The scale was worse than I expected. A quick audit showed 130 out of 340+ plugins had stub SKILL.md files. That's 38% of the marketplace shipping empty documentation. Every one of those plugins was discoverable, installable, and completely undocumented beyond its name. Replacing Stubs at Scale with Ve

Continue reading on Dev.to Webdev

Opens in a new tab

Read Full Article
2 views

Related Articles