AgentSkillsCN

readmes

检查所有 README 文件，确保元仓库中的内容准确一致

SKILL.md
--- frontmatter
name: readmes
description: "Check all READMEs for accuracy and consistency across the meta-repo"
model: claude-haiku-4-5-20251001
allowed-tools: Read, Edit, Glob, Grep

/readmes

Comprehensive review and update of all README.md files in the meta-repo.

Usage

bash
/readmes    # Review all READMEs in ideas/ directory

Scope

Includes:

  • •ideas/[project]/README.md - All project overviews
  • •ideas/[project]/apps/*/README.md - Multi-app project READMEs
  • •Root-level documentation files

Excludes:

  • •spaces/ directory (code repos have their own maintenance)
  • •Build artifacts, node_modules, etc.

Execution Flow

1. Discover All READMEs

bash
Glob: ideas/**/README.md

2. Review Each README

For each README, technical-writer agent checks:

  • •Status accuracy: Matches CLAUDE.md Current Projects?
  • •Date accuracy: Is "Last Updated" current?
  • •Link validity: Are all links working?
  • •Content completeness: Required sections present?
  • •Consistency: Formatting matches standards?

3. Update READMEs

  • •Fix outdated status indicators
  • •Update dates to current date
  • •Fix broken links
  • •Add missing sections
  • •Standardize formatting

4. Report Results

Summary includes:

  • •READMEs reviewed (count)
  • •Updates made (list of files)
  • •Issues requiring manual attention

What Gets Checked

AspectValidation
StatusMatches CLAUDE.md
Dates"Last Updated" is accurate
LinksInternal refs work
StructureHas required sections
ConsistencyFollows template

When to Use

  • •After major project updates
  • •Before project reviews/demos
  • •Monthly documentation maintenance
  • •After status changes in CLAUDE.md

Notes

  • •Read then write: Agent reads each file before making changes
  • •Preserves content: Only updates metadata and known sections
  • •Non-destructive: Doesn't remove custom content
  • •Idempotent: Safe to run multiple times

Integration

code
Update CLAUDE.md status → /readmes → Verify changes