cyberneticlibrary

Audit ecosystem version alignment

ecosystem-alignmentskillsetup L1381
majiayu000/claude-skill-registry
What it does

Audit Claude Code version alignment and agentskills.io spec compliance

Best for

Keeping a custom Claude Code setup in sync with upstream platform updates, preventing drift and discovering new capabilities to adopt.

Inputs
  • · Installed Claude Code version
  • · Skill description files (SKILL.md)
  • · Hook configuration files
  • · Current agentskills.io specification
Outputs
  • · Version compatibility report (Claude Code, GSD upstream, agentskills.io)
  • · Skill compliance audit results (description length, schema validity)
  • · Hook health status (dead references, syntax errors, missing hook types)
  • · Feature gap analysis identifying unmet platform capabilities
  • · Prioritized action items for alignment
Requires
  • · Bash CLI (grep, strings, sed)
  • · Claude Code binary
  • · NPM (for package.json introspection)
Preconditions
  • · Claude Code installed with known version
  • · Skill files structured with SKILL.md convention
  • · agentskills.io specification reference (250-char limit for descriptions, etc.)
  • · Access to hook configuration files
Failure modes
  • · Spec changes published before this alignment tool is updated
  • · New hook types introduced without documentation
  • · Skills with descriptions >250 chars (agentskills.io rejects silently)
  • · Hook files with ESM syntax in .js files (CJS required)
  • · Dead hook references pointing to non-existent files
  • · Feature detection missing newer platform capabilities
Trust signals
  • · Automated version checks reduce manual drift
  • · Compliance checklist enforces agentskills.io constraints
  • · Hook audit catches syntax/reference errors before runtime
  • · Binary string analysis discovers new internal patterns automatically
  • · Prioritized action items guide adoption order