skills.rest
mayknxyz
mayknxyzCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mk.repo

Audits CLAUDE.md references, README freshness, and file structure to output a structured health report with fixes.

Updated Aug 23, 2026
Search Tags:#documentation#audit#readme#claude-md#repo-health#context-hygiene#stale-references
One-click install
npx skills add https://github.com/mayknxyz/my-kit --skill mk-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mk.repo
Source: https://github.com/mayknxyz/my-kit/tree/main/kit/.claude/skills/mk.repo
Command: npx skills add https://github.com/mayknxyz/my-kit --skill mk-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Repository health assessment that ensures CLAUDE.md references, README freshness, and file-structure hygiene stay accurate, reducing context drift for AI-assisted maintenance.

Core Features & Use Cases

  • Holistic repo health analysis focusing on CLAUDE.md accuracy, README freshness, and file-structure noise to improve AI-assisted maintenance and governance.
  • Clear routing and reference-driven execution to support repeatable health checks across multiple projects.
  • Use cases include scheduled audits for large codebases, onboarding checks for new repos, and cleanup of stale references and orphaned configs.

Quick Start

Run a full health check on your repository to generate a structured report with suggested fixes.

Frequently Asked Questions about mk.repo

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

FAQPage Schema
How do I audit repository health and fix stale documentation references?▼

To audit repository health, run a full health check that scans CLAUDE.md references, README freshness, and file structure to detect broken references and output a structured report with actionable fixes.

What does a repo health audit check for in AI-assisted maintenance?▼

A repo health audit checks for accurate CLAUDE.md references, README freshness, and file-structure hygiene to prevent context drift and ensure AI-assisted maintenance operates on valid repository metadata.

How do I detect broken CLAUDE.md references and outdated README files in my codebase?▼

Detect broken CLAUDE.md references and outdated README files by executing a holistic health analysis that validates file presence, checks git prerequisites, and flags noisy structures hindering AI context accuracy.

Can I run automated repository health checks across multiple software projects?▼

Yes, you can run repeatable health checks across multiple software projects using clear routing and reference-driven execution, making it suitable for scheduled audits of large codebases and onboarding checks for new repos.

Do I need git prerequisites to audit repo health and clean up orphaned configs?▼

Yes, git prerequisites are validated during the repository health audit to ensure accurate file structure analysis and successful cleanup of stale references and orphaned configs.

What's the best way to maintain context hygiene for AI-assisted repository maintenance?▼

Maintain context hygiene by performing regular repository health assessments that identify broken references, outdated documentation, and noisy file structures, then applying the suggested fixes from the structured health report.

Related Skills

Explore More Software Engineering Skills→
tomzxtomzx
5

onboard-repository

Bootstrap repository onboarding with SDLC structure and automated issue triage workflows.

Community
Advanced
octavehqoctavehq
11

audit

Audit an Octave library for gaps, stale content, and broken links.

Official
Advanced
jgezelscorpjgezelscorp

count-registry

Maintain entity counts in a project via a manifest file and automated validation.

Community
Basic
l3ochol3ocho

staleness-metrics

Measure documentation freshness against code changes and generate staleness reports.

Community
Advanced