ruvnet/ruflo742 installs
validate-plugin
Validate a Claude Code plugin structure, frontmatter, and MCP tool references
How do I install this agent skill?
npx skills add https://github.com/ruvnet/ruflo --skill validate-pluginIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill validates the structure and configuration of Claude Code plugins by checking directories, manifests, and tool prefixes. It uses local scripts and an NPM package to perform comprehensive checks on plugin components.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Validate Plugin
Validate that a plugin follows the correct Claude Code plugin format.
When to use
After creating or modifying a plugin, run validation to catch structural issues before publishing.
Checks performed
- Directory structure —
.claude-plugin/plugin.jsonexists at plugin root - plugin.json schema — required fields present (name, description, version, non-empty keywords array);
nameequals the directory name; version is semver - Skills auto-discovery — every
skills/<name>/SKILL.mdis a valid skill (Claude Code auto-discovers from directory;plugin.jsonMUST NOT list askillsarray) - Commands auto-discovery — every
commands/<name>.mdis a valid command (auto-discovered; nocommandsarray inplugin.json) - Agents auto-discovery — every
agents/<name>.mdis a valid agent (auto-discovered; noagentsarray inplugin.json) - No legacy arrays in plugin.json — presence of
skills,commands, oragentsarrays inplugin.jsonis a validation error (they cause Claude Code to reject the plugin) - SKILL.md frontmatter — each skill has
name,description, andallowed-tools(no wildcards) - Agent frontmatter — each agent has
name,description, andmodel - No files in wrong locations — skills/commands/agents not inside
.claude-plugin/ - MCP tool references — tools in
allowed-toolsuse themcp__plugin_ruflo-core_ruflo__*prefix AND exist: list the real tools withnpx @claude-flow/cli@latest mcp toolsand flag any name not in it (typos such ashooks_post_taskforhooks_post-task, oragentdb_pattern_searchforagentdb_pattern-search, are format-valid but do not exist). Also run the repo gates when inside the ruflo repo:node scripts/audit-skill-frontmatter.mjs,audit-plugin-manifest.mjs,audit-plugin-mcp-prefix.mjs
Steps
- Read the plugin's
plugin.jsonand assert noskills/commands/agentsarrays present - Glob
skills/*/SKILL.md,commands/*.md,agents/*.mdand validate each frontmatter - For each SKILL.md, verify frontmatter has required fields and
allowed-toolshas no wildcards - For each agent .md, verify frontmatter has required fields
- Report pass/fail for each check with actionable fix suggestions
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/ruvnet/ruflo/validate-plugin">View validate-plugin on skillZs</a>