urmzd/dotfiles / dot_agents/skills/align-readmes
align-readmes
VerifiedAudit and converge README.md across every local urmzd/* checkout so the fleet reads as one product: skip archived repos, flag renamed repos and stale identities, score each README against write-readme, then fix in priority order. Use when the user asks to consolidate, unify, standardize, or audit READMEs across repos, or after a rename wave. Do NOT use for a single repo's README (use write-readme), prose cleanup alone (use clean-docs), or whole-repo convention drift (use sync-ecosystem).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
| scripts/executable_audit-readmes.sh | script | 2.1 KB |
scripts/executable_audit-readmes.sh
View on GitHub#!/usr/bin/env bash
# Fleet README audit. Read-only. Prints one row per repo under ROOT.
# Usage: audit-readmes.sh [ROOT] (default: ~/github)
set -euo pipefail
ROOT="${1:-$HOME/github}"
{
printf '%s\n' "repo status identity hdr badges em_dash tree toc_needed quick_start skill_2nd license_last"
for dir in "$ROOT"/*/; do
dir="${dir%/}"
name="$(basename "$dir")"
readme="$dir/README.md"
[ -d "$dir/.git" ] || continue
remote="$(git -C "$dir" remote get-url origin 2>/dev/null | sed -E 's#.*[:/]([^/]+/[^/]+)$#\1#; s#\.git$##')"
status="no-remote"; remote_ok="-"
if [ -n "$remote" ]; then
meta="$(gh repo view "$remote" --json nameWithOwner,isArchived --jq '"\(.nameWithOwner) \(.isArchived)"' 2>/dev/null || echo "missing missing")"
canonical="${meta% *}"; archived="${meta#* }"
case "$archived" in
true) status="ARCHIVED" ;;
false) status="active" ;;
*) status="MISSING" ;;
esac
# gh follows rename redirects: a remote mismatch means a stale remote URL,
# a dir mismatch means the checkout folder predates a rename.
if [ "$canonical" != "$remote" ]; then remote_ok="stale-remote:$canonical"
elif [ "${canonical#*/}" != "$name" ]; then remote_ok="dir-is:${canonical#*/}"
else remote_ok="ok"; fi
fi
if [ ! -f "$readme" ]; then
printf '%s\n' "$name $status $remote_ok NO-README - - - - - - -"
continue
fi
lines="$(wc -l < "$readme" | tr -d ' ')"
hdr="$(head -3 "$readme" | grep -c 'align="center"' || true)"
badges="$(grep -cE '<img src=[^>]*(badge|shields)' "$readme" || true)"
em="$(grep -c $'—' "$readme" || true)"
tree="$(grep -cE '├──|└──' "$readme" || true)"
toc="-"
if [ "$lines" -ge 300 ]; then grep -q '^## Contents' "$readme" && toc="ok" || toc="MISSING"; fi
qs="$(grep -q '^## Quick Start' "$readme" && echo ok || echo MISSING)"
sections="$(grep '^## ' "$readme" || true)"
skill="$(echo "$sections" | tail -2 | head -1 | grep -q 'Agent Skill' && echo ok || echo no)"
lic="$(echo "$sections" | tail -1 | grep -q 'License' && echo ok || echo no)"
printf '%s\n' "$name $status $remote_ok $hdr $badges $em $tree $toc $qs $skill $lic"
done
} | column -t
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |