Sync docs
harness-evalFrom the repository description
npx -y skills add whchoi98/harness-eval --skill sync-docsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.8 KB, as published. Nobody here has run it
Sync Docs Skill
Synchronize project documentation with current code state.
Actions
1. Quality Assessment
Score each CLAUDE.md file (0-100) across:
- Commands/workflows (20 pts)
- Architecture clarity (20 pts)
- Non-obvious patterns (15 pts)
- Conciseness (15 pts)
- Currency (15 pts)
- Actionability (15 pts)
Apply anti-pattern deductions:
- Over 500 lines (-15)
- Vague instructions (-10)
- Duplicated docs (-10)
- No test guidance (-10)
- Contains secrets (-20)
Output quality report with grades (A-F) before making changes.
2. Root CLAUDE.md Sync
- Update Overview, Tech Stack, Conventions, Key Commands
- Verify commands are copy-paste ready against actual scripts
3. Architecture Doc Sync
- Update docs/architecture.md to reflect current system structure
- Add new components, update data flows, reflect infrastructure changes
4. Module CLAUDE.md Audit
- Scan all directories under plugin root
- Create CLAUDE.md for modules missing one
- Update existing module CLAUDE.md files if out of date
- Score each module CLAUDE.md
5. ADR and Runbook Audit
- Check recent commits for undocumented architectural decisions
- Verify runbook coverage against project characteristics
- Flag stale ADRs and outdated runbooks
6. Manifest Sync (monorepo)
plugins/harness-eval/.claude-plugin/plugin.jsonis metadata-only (noskills/agents/commands/hookspath arrays — those are auto-discovered), so validate the auto-discovered component directories exist instead of checking path arrays.- Verify version consistency across all three locations:
plugins/harness-eval/.claude-plugin/plugin.json(version) and.claude-plugin/marketplace.json(metadata.versionandplugins[].version).
7. Report
Output before/after quality scores, anti-patterns detected, and list of all changes.