What format are the reports generated in?

Reports are generated as Markdown (.md) files using GitHub Flavored Markdown, featuring a YAML frontmatter block for structured metadata.

Can I track changes in metrics over time?

Yes, the report format supports a 'previousValue' field in the metrics section, allowing for delta comparisons between current and past results.

Where should I store these generated reports?

The skill follows a convention of placing reports in a 'reports/' directory, typically managed on a dedicated orphan git branch to keep them separate from source code.

What types of audits can this skill perform?

It is designed for a wide range of audits including security scans, performance (Lighthouse) checks, accessibility compliance, SEO audits, and general code quality metrics.

How does the tagging system work?

Tags are automatically generated based on the directory structure (e.g., reports/security/ results in a 'security' tag) and can be further customized in the YAML frontmatter.

GitHub Repo Health Reports

Name: GitHub Repo Health Reports
Author: decocms

bydecocms

•

Analytics & Monitoring

Generates structured Markdown reports with YAML frontmatter for repository health monitoring, audits, and performance tracking.

This skill enables Claude to perform comprehensive repository health checks and document findings in a standardized, machine-readable format. It creates detailed Markdown reports featuring YAML metadata for various categories including security, performance, and code quality. By organizing data into structured metrics and tables and integrating with Git workflows via a dedicated branch, it allows development teams to maintain a historical record of audits, track project vitals over time, and automate the reporting of scan results directly within their version control system.

Key Features

01Predefined status levels (passing, warning, failing, info) for quick health assessments.

02Standardized YAML frontmatter for machine-readable report metadata and filtering.

03Automated directory-based tagging for organized navigation of health check history.

048 GitHub stars

05Structured content sections for performance metrics, data tables, and free-form Markdown analysis.

06Integrated Git workflow for committing reports to dedicated branches like 'reports'.

Use Cases

01Maintaining a code quality log that tracks test coverage and linting results across different modules.

02Conducting periodic security audits and documenting dependency vulnerabilities in a structured table.

03Generating performance reports with Core Web Vitals and comparing them against previous values.

Key Features

01Predefined status levels (passing, warning, failing, info) for quick health assessments.

02Standardized YAML frontmatter for machine-readable report metadata and filtering.

03Automated directory-based tagging for organized navigation of health check history.

048 GitHub stars

05Structured content sections for performance metrics, data tables, and free-form Markdown analysis.

06Integrated Git workflow for committing reports to dedicated branches like 'reports'.

Use Cases

01Maintaining a code quality log that tracks test coverage and linting results across different modules.

02Conducting periodic security audits and documenting dependency vulnerabilities in a structured table.

03Generating performance reports with Core Web Vitals and comparing them against previous values.