script-ecosystem-audit

Audit repository script infrastructure and output a v2 JSON health report.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/jasonmichaelbell78-creator/framework --skill script-ecosystem-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: script-ecosystem-audit
Source: https://github.com/jasonmichaelbell78-creator/framework/tree/main/.claude/skills/script-ecosystem-audit
Command: npx skills add https://github.com/jasonmichaelbell78-creator/framework --skill script-ecosystem-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Script Ecosystem Audit addresses the challenge of invisible, evolving health risks in a repository's script infrastructure by providing a structured, automated health check that surfaces issues before they impact development velocity.

Core Features & Use Cases

  • Comprehensive domain checks spanning module systems, safety, registration, code quality, and testing.
  • Per-category scoring, composite health grade, trends, patch suggestions, and a detailed findings walkthrough.
  • State persistence and baseline comparison for historical trend analysis and regression detection.

Quick Start

Run the audit to generate a comprehensive health report of the repository's script ecosystem.

Frequently Asked Questions about script-ecosystem-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an automated health audit on my repository's script infrastructure?

To run a script infrastructure health audit, execute the audit process to analyze your entire /scripts/ directory. It evaluates module consistency, safety, registration, code quality, and testing, then outputs a structured JSON report containing findings, category scores, and patch suggestions.

What does a script infrastructure health check evaluate?

A script infrastructure health check evaluates module systems, safety, registration, code quality, and testing domains. It assigns per-category scores and a composite health grade to surface invisible risks and identify issues before they impact development velocity.

Can I track script health trends and regressions over time?

Yes, you can track script health trends through state persistence and baseline comparison. The audit maintains a historical state log, enabling trend analysis and regression detection across multiple runs to monitor evolving health risks.

What format does the script ecosystem audit output use?

The script ecosystem audit outputs a v2 JSON payload. This structured format includes detailed findings, category scores, historical trends, and actionable patch suggestions for identified code issues.

When should I use an automated script health audit?

You should use an automated script health audit when your repository's script ecosystem grows complex and risks becoming invisible. It proactively surfaces module and testing issues before they impact development velocity.

Are there limitations to what the script health audit checks?

The audit applies specifically to the /scripts/ ecosystem. While it comprehensively scores module consistency, safety, registration, code quality, and testing, it does not evaluate code outside this directory structure.