Skip to content

Add plugin validation to release pre-flight checks #8

@b-coman

Description

@b-coman

Context

Anthropic provides a built-in plugin validator (`claude plugin validate .`) that checks plugin.json, skill/agent/command frontmatter, hooks.json syntax, and schema conformance. We are not running it as part of our release process.

Additionally, the Agent Skills ecosystem provides a cross-tool validator (`skills-ref validate`) and a community linter (`claudelint`) that catch broader issues.

Problem

Without automated validation:

  • Frontmatter typos or schema violations ship silently
  • Skills may fail to load in Claude Code without any pre-release signal
  • Format drift from Anthropic's evolving spec goes unnoticed
  • Our release script (`scripts/release.sh`) runs Layer 1 pre-flight checks but doesn't include plugin format validation

Deliverables

  • Add `claude plugin validate .` to `scripts/release.sh` pre-flight checks (runs before version bump)
  • Evaluate and optionally add `skills-ref validate` (pip package from agentskills.io) as a second check
  • Document the validation step in CLAUDE.md release section

Acceptance criteria

Dependencies

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    infrastructureTooling, hooks, release, CIround-4v0.8.0 design refinement package

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions