anthropic-docs-updater

anthropic-docs-updater automatically keeps the anthropic-expert skill current by detecting, fetching, and integrating Anthropic documentation updates.

Purpose: Automated documentation maintenance for anthropic-expert

Update Workflow (5 steps):

1. Check for Updates - Detect new releases and documentation changes
2. Fetch Documentation - Download updated content from official sources
3. Process Content - Convert to skill reference format
4. Update Skill - Integrate new content into anthropic-expert
5. Validate Updates - Ensure quality maintained, no regressions

Automation: 80% automated (manual review for breaking changes)

Update Sources:

• GitHub Releases (SDK version updates)
• docs.claude.com/en/release-notes (API updates)
• code.claude.com/docs/en/changelog (Claude Code updates)
• anthropic.com/news (model announcements)

• Weekly/monthly update checks (stay current)
• After Anthropic announces new features
• Before starting new Anthropic project (ensure latest docs)
• When anthropic-expert seems outdated
• Automated scheduled updates (cron job)

• anthropic-expert skill installed
• Python 3.7+ with requests library
• GitHub API access (for release checking)
• Internet access (for fetching docs)

Step 1: Check for Updates

Purpose: Detect new releases, documentation changes, feature announcements

Process:

1. Check GitHub Releases

```bash

python scripts/check-updates.py --github

```

- Queries GitHub API for latest releases

- Checks: anthropic-sdk-python, claude-agent-sdk-python

- Compares to current versions in changelog.md

- Reports new releases found

1. Check Release Notes

```bash

python scripts/check-updates.py --docs

```

- Fetches docs.claude.com/en/release-notes

- Compares to last check date

- Identifies new entries

1. Check Claude Code Changelog

```bash

python scripts/check-updates.py --claude-code

```

- Fetches code.claude.com/docs/en/changelog

- Detects new versions or features

1. Generate Update Report

```bash

python scripts/check-updates.py --all

```

- Runs all checks

- Aggregates findings

- Outputs: update-report.txt with detected changes

Validation:

• [ ] GitHub releases checked
• [ ] Release notes checked
• [ ] Claude Code changelog checked
• [ ] Update report generated
• [ ] New updates detected (or confirmed current)

Outputs:

• update-report.txt (what's new)
• List of detected changes
• Recommended update actions

Time Estimate: 10-15 minutes (automated)

Example Output:

```

Anthropic Documentation Update Check

=====================================

Date: 2025-11-15

GitHub Releases:

✅ anthropic-sdk-python: v0.45.0 (current: v0.42.0) - UPDATE AVAILABLE

✅ claude-agent-sdk-python: v1.12.0 (current: v1.10.0) - UPDATE AVAILABLE

Release Notes (docs.claude.com):

✅ New feature: Batch API cost reduction increased to 60%

✅ New model: Claude Sonnet 4.6 announced

Claude Code Changelog:

• No new updates since last check

Recommendation: UPDATE AVAILABLE

• 2 SDK updates
• 2 API feature updates
• Proceed to Step 2 (Fetch Documentation)

```

---

Step 2: Fetch Documentation

Purpose: Download updated content from official sources

Process:

1. Fetch SDK Documentation

```bash

python scripts/fetch-docs.py --github-readmes

```

- Downloads README.md from SDK repositories

- Gets changelog/release notes from GitHub

- Saves to temp/sdk-docs/

1. Fetch API Documentation

```bash

python scripts/fetch-docs.py --api-docs

```

- Fetches updated pages from docs.claude.com

- Downloads release notes

- Saves to temp/api-docs/

1. Fetch Claude Code Documentation

```bash

python scripts/fetch-docs.py --claude-code-docs

```

- Fetches updated pages from code.claude.com

- Downloads changelog

- Saves to temp/claude-code-docs/

1. Verify Downloads

- Check all files downloaded successfully

- Validate file integrity

- Confirm no download errors

Validation:

• [ ] SDK docs fetched successfully
• [ ] API docs fetched successfully
• [ ] Claude Code docs fetched (if updates)
• [ ] All files saved to temp directory
• [ ] No download errors

Outputs:

• temp/sdk-docs/ (SDK documentation)
• temp/api-docs/ (API documentation)
• temp/claude-code-docs/ (Claude Code documentation)
• fetch-log.txt (download log)

Time Estimate: 15-30 minutes (automated, depends on amount of content)

---

Step 3: Process Documentation

Purpose: Convert fetched content to skill reference format

Process:

1. Parse Fetched Documentation

```bash

python scripts/process-docs.py --input temp/ --output processed/

```

- Parses markdown from temp/

- Extracts relevant sections

- Identifies code examples

- Structures by product

1. Convert to Reference Format

- Organize by product/capability

- Format consistently with existing references

- Extract code examples properly

- Add navigation headers

1. Merge with Existing Content

- Compare new vs existing documentation

- Identify additions, changes, removals

- Preserve custom examples/notes

- Generate diff report

1. Validate Processed Content

- Check markdown syntax

- Verify code examples

- Ensure consistent formatting

Validation:

• [ ] All fetched docs processed
• [ ] Content converted to reference format
• [ ] Organized by product/capability
• [ ] Code examples extracted correctly
• [ ] Diff report generated (what changed)
• [ ] Processed content validated

Outputs:

• processed/ (processed documentation)
• diff-report.txt (what changed)
• Formatted content ready for integration

Time Estimate: 20-40 minutes (automated with manual review of diff)

---

Step 4: Update anthropic-expert Skill

Purpose: Integrate new content into anthropic-expert skill safely

Process:

1. Backup Current Skill

```bash

python scripts/update-skill.py --backup

```

- Creates backup of anthropic-expert

- Saves to anthropic-expert.backup-YYYYMMDD/

- Preserves all files

1. Integrate New Content

```bash

python scripts/update-skill.py --integrate processed/

```

- Updates relevant reference files

- Adds new features to appropriate sections

- Preserves custom content

- Updates changelog.md with changes

1. Update Version

- Increments version number

- Updates changelog with:

- Version number

- Date

- Changes summary

- New features

- Updated documentation

1. Review Changes

- Display diff of what changed

- Prompt for confirmation (if manual mode)

- Allow rollback if issues

Validation:

• [ ] Current skill backed up
• [ ] New content integrated successfully
• [ ] Changelog updated with version and changes
• [ ] No merge conflicts
• [ ] All reference files valid markdown
• [ ] Ready for validation step

Outputs:

• Updated anthropic-expert skill
• Backup in anthropic-expert.backup-*/
• Updated changelog.md
• Integration log

Time Estimate: 15-30 minutes (automated, quick review)

---

Step 5: Validate Updates

Purpose: Ensure updates maintain quality and don't introduce regressions

Process:

1. Run Structure Validation

```bash

python ../../review-multi/scripts/validate-structure.py ../anthropic-expert

```

- Validates YAML frontmatter

- Checks file structure

- Verifies naming conventions

- Ensures progressive disclosure

- Must pass (5/5 or 4/5)

1. Test Search Functionality

```bash

python ../anthropic-expert/scripts/search-docs.py "test query"

```

- Verify search still works

- Check can find content in updated files

- Ensure no search errors

1. Manual Spot Check

- Review 2-3 updated sections

- Verify accuracy of new content

- Check code examples valid

- Ensure formatting consistent

1. Validation Decision

- PASS: All validations successful → Finalize update

- FAIL: Issues found → Rollback and investigate

1. Rollback if Failed (if validation fails)

```bash

python scripts/update-skill.py --rollback

```

- Restores from backup

- Reverts to previous version

- Logs failure for investigation

Validation:

• [ ] Structure validation passes (≥4/5)
• [ ] Search functionality works
• [ ] Spot check confirms accuracy
• [ ] No regressions detected
• [ ] Quality maintained
• [ ] Update finalized OR rolled back if issues

Outputs:

• Validation report
• Final updated skill (if passed)
• OR restored backup (if failed)
• Update success/failure status

Time Estimate: 20-30 minutes

---

If Successful:

1. ✅ anthropic-expert updated with latest documentation
2. ✅ Changelog.md updated with changes
3. ✅ Quality validated (structure 5/5)
4. ✅ Ready to use with latest Anthropic features

If Failed:

1. ❌ Updates rolled back
2. 📋 Investigation needed (check logs)
3. 🔄 Manual review of changes
4. 🛠️ Fix issues and retry

Next Check: Weekly or when Anthropic announces updates

---

1. Schedule Regular Updates

Practice: Weekly automated check for updates

Implementation: Cron job or scheduled task

```bash

# Weekly check (Mondays at 9am)

0 9 1 cd /path/to/skills && python anthropic-docs-updater/scripts/check-updates.py --all

```

2. Review Breaking Changes Manually

Practice: For major version updates, review changes before applying

Why: Breaking changes may require manual updates to examples

3. Backup Before Updating

Practice: Always backup (Step 4 does this automatically)

Why: Can rollback if updates cause issues

4. Validate After Updates

Practice: Always run Step 5 (validation)

Why: Ensures updates don't break skill quality

5. Track Update History

Practice: Maintain detailed changelog

Why: Understand what changed when, aids troubleshooting

---

The 5-Step Update Workflow

| Step | Focus | Time | Automation | Output |

|------|-------|------|------------|--------|

| 1. Check Updates | Detect changes | 10-15m | 100% | update-report.txt |

| 2. Fetch Docs | Download content | 15-30m | 100% | temp/docs/ |

| 3. Process Content | Convert format | 20-40m | 90% | processed/docs/ |

| 4. Update Skill | Integrate content | 15-30m | 95% | Updated skill |

| 5. Validate | Ensure quality | 20-30m | 70% | Validation report |

Total Time: 1.5-2.5 hours (mostly automated)

Update Sources

| Source | What It Tracks | Check Method |

|--------|----------------|--------------|

| GitHub Releases | SDK versions | GitHub API |

| Release Notes | API features | Web scraping |

| Claude Code Changelog | CLI updates | Web scraping |

| Anthropic News | Model announcements | Manual/RSS |

Common Commands

```bash

# Check for updates

python scripts/check-updates.py --all

# Fetch new documentation

python scripts/fetch-docs.py --all

# Process fetched docs

python scripts/process-docs.py --input temp/ --output processed/

# Apply updates

python scripts/update-skill.py --integrate processed/

# Validate

python scripts/update-skill.py --validate

# Rollback if needed

python scripts/update-skill.py --rollback

```

Automation Schedule

Recommended: Weekly checks, monthly comprehensive updates

Cron Example (check weekly, update monthly):

```bash

# Check for updates every Monday

0 9 1 python check-updates.py --all > /tmp/anthropic-updates.log

# Full update first Monday of month

0 10 1-7 * 1 bash run-full-update.sh

```

---

anthropic-docs-updater ensures anthropic-expert stays current with the latest Anthropic products, features, and documentation through automated update detection, fetching, processing, and integration.