tools: add skill surface audit script

[gaelic-ghost]

Summary

• add a report-only skill surface audit script for Socket skill and reference hotspots
• add tests for line counts, duplicate references, repeated phrases, version-sensitive wording, and handoff checks
• update the audit report with the implemented script and live baseline

Verification

• uv run ruff check .
• uv run mypy
• uv run pytest
• uv run scripts/audit_skill_surfaces.py --format json --top 3
• uv run scripts/validate_socket_metadata.py

[coderabbitai]

Warning

Review limit reached

@gaelic-ghost, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 42 minutes and 1 second. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8dddd752-7650-4f9a-a75f-0410a7a14674

📥 Commits

Reviewing files that changed from the base of the PR and between fa1ed2d and de5f92b.

📒 Files selected for processing (3)

• docs/agents/token-efficiency-automation-audit-2026-06-22.md
• scripts/audit_skill_surfaces.py
• tests/test_audit_skill_surfaces.py

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch audit/token-efficiency-automation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}