system-audit

Validate JYH-OS repository configuration and detect structural, dependency, and runtime issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JYHTHEGREAT/jyh-system --skill system-audit-jyhthegreat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-audit
Source: https://github.com/JYHTHEGREAT/jyh-system/tree/main/skills/system-audit
Command: npx skills add https://github.com/JYHTHEGREAT/jyh-system --skill system-audit-jyhthegreat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Validate and report on the correctness of a JYH-OS repository's configuration, component dependencies, and runtime state to surface missing files, broken references, configuration drift, and operational warnings without performing any automated fixes.

Core Features & Use Cases

  • Three-layer verification: Structural Integrity checks references and file existence, Relationship Graph builds dependency and impact maps, Runtime Health inspects live artifacts and observations.
  • Impact analysis: Trace upstream and downstream effects for a changed file or component to guide safe updates and PR scope.
  • Qualitative review: Integrates mechanical checks with a rubric-driven review (review.py + claudemd-rubric) for docs, commands, and workflow quality assessment.
  • Non-destructive reporting: Produces human-readable markdown and optional JSON outputs; never performs automatic remediation.

Quick Start

Run a full audit on the current repository and emit a JSON report by invoking the skill in full mode.

Frequently Asked Questions about system-audit

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

FAQPage Schema
How do I check system integrity and detect broken references in a project repository?

System integrity validation checks structural file existence and references, relationship graphs map dependencies, and runtime health inspects live artifacts to surface missing files and configuration drift in markdown and JSON reports.

Can I trace the upstream and downstream impact of a changed file before updating?

Yes, you can trace upstream and downstream impact for a changed file by running an impact analysis. This maps dependency relationships to guide safe updates and define PR scope without automatically modifying your codebase.

How do I generate a dependency graph for my project components?

Generate a dependency graph by running the audit script in dependency graph mode. It maps component relationships and outputs structural connections, producing both human-readable markdown and machine-readable JSON artifacts.

Does the system audit perform automatic remediation for configuration drift?

No, the system audit does not perform automatic remediation. It provides non-destructive reporting by surfacing missing files and configuration drift in markdown and JSON outputs, leaving all fixes to manual review.

What is the best way to assess documentation and workflow quality during a repository review?

Assess documentation and workflow quality by running a rubric-driven review using the review script. It integrates mechanical checks with qualitative rubric assessment to evaluate docs, commands, and workflow quality in markdown reports.

Do I need a specific directory layout to validate runtime health and component dependencies?

Yes, you need a project organized under a ~/.claude layout to validate runtime health and component dependencies. The audit scripts rely on this JYH-OS repository structure to inspect live artifacts and build accurate relationship graphs.