agentsclimarketplace

Sync docs

Skill whchoi98/harness-eval/.claude/skills/sync-docs

harness-evalFrom the repository description

Install
npx -y skills add whchoi98/harness-eval --skill sync-docs

Assembled 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.json is metadata-only (no skills/agents/commands/hooks path 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.version and plugins[].version).

7. Report

Output before/after quality scores, anti-patterns detected, and list of all changes.

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.