Skip to content

chore(skills): optimize updating and updating-checksums reference docs#1136

Merged
jdalton merged 4 commits intomainfrom
chore/improve-skill-references
Mar 31, 2026
Merged

chore(skills): optimize updating and updating-checksums reference docs#1136
jdalton merged 4 commits intomainfrom
chore/improve-skill-references

Conversation

@jdalton
Copy link
Copy Markdown
Contributor

@jdalton jdalton commented Mar 31, 2026

Summary

  • Trim updating-checksums/reference.md from 253 → ~80 lines: remove stale release asset filename patterns, collapse duplicate command/output sections, tighten troubleshooting
  • Trim updating/reference.md from 229 → ~70 lines: remove monorepo structure diagram (derivable from repo), collapse redundant npm update detail, tighten CI/interactive mode table

Changes follow Claude agent skills best practices:

  • Concise reference files (context window is a shared resource)
  • No time-sensitive content (asset filename patterns go stale)
  • No information Claude already knows (monorepo layout, basic pnpm commands)
  • Progressive disclosure: SKILL.md stays as the entry point, reference.md covers only what isn't obvious

Test plan

  • Skills remain functionally complete — all commands, edge cases, and troubleshooting preserved

Note

Low Risk
Low risk documentation-only change; no runtime code paths or build logic are modified.

Overview
Adds .claude/skills/updating/reference.md and .claude/skills/updating-checksums/reference.md to document the expected workflows for npm dependency updates (pnpm run update) and external tool checksum syncing (sync-checksums.mjs), including command examples and when to run each step.

Includes concise guidance on checksum sources/formats, GitHub-release vs non-GitHub tool handling, and troubleshooting for common sync failures (rate limits, missing releases, JSON validation, large downloads).

Written by Cursor Bugbot for commit e0c23d7. Configure here.

@jdalton jdalton enabled auto-merge (squash) March 31, 2026 03:55
@jdalton jdalton force-pushed the chore/improve-skill-references branch from e0c23d7 to 74c939e Compare March 31, 2026 12:31
jdalton added 3 commits March 31, 2026 08:48
…pdating-checksums

- sfw repository: SocketDev/sfw -> SocketDev/sfw-free
- socket-patch repository: nicolo-ribaudo/tc39-proposal-patcher -> SocketDev/socket-patch
- Clarify sfw dual config: npmPackage/npmVersion fields track npm component
- Fix expected output tool count: 7 -> 6 github-release tools
@jdalton jdalton merged commit bfaf564 into main Mar 31, 2026
5 checks passed
@jdalton jdalton deleted the chore/improve-skill-references branch March 31, 2026 20:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants