Skip to content

voltagent-qa-sec v1.1.0 fails to load: plugin.json references 2 missing agent files #240

Closed

Description

@etannous

Bug

Installing voltagent-qa-sec@voltagent-subagents via the Claude Code plugin marketplace fails to load.

$ claude plugin list
...
  ❯ voltagent-qa-sec@voltagent-subagents
    Version: 1.1.0
    Scope: user
    Status: ✘ failed to load
    Error: Path not found: <cache>/voltagent-qa-sec/1.1.0/cost-accounting-performance-reviewer.md (agents)
    Error: Path not found: <cache>/voltagent-qa-sec/1.1.0/performance-roi-translator.md (agents)

Root cause

categories/04-quality-security/.claude-plugin/plugin.json (v1.1.0) declares 18 agents in its agents[] array, but only 16 .md files exist in categories/04-quality-security/.

Missing files:

  • cost-accounting-performance-reviewer.md
  • performance-roi-translator.md

These two entries appear to have been added to plugin.json without committing the corresponding agent definitions.

Because Claude Code rejects the entire plugin when any declared agent path is invalid, all 16 valid security/QA agents are blocked — security-auditor, penetration-tester, code-reviewer, qa-expert, compliance-auditor, etc.

Repro

  1. claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
  2. claude plugin install voltagent-qa-sec@voltagent-subagents
  3. claude plugin list → voltagent-qa-sec shows ✘ failed to load

Suggested fix

Two options:

  1. Quick fix: remove the two orphan entries from plugin.json (proposed in fix(qa-sec): remove orphan agent entries from plugin.json #239)
  2. Full fix: commit the missing cost-accounting-performance-reviewer.md and performance-roi-translator.md agent definitions

PR #239 implements option 1.

Environment

  • Claude Code: v2.x (Windows 11)
  • voltagent-qa-sec: 1.1.0
  • voltagent-subagents marketplace: 1.0.2

Activity

  1. added a commit that references this issue on May 4, 2026
    34a5ef4
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions