Agent skill

sync-docs

Sync official Anthropic documentation and analyze impact on project components. Runs docs/reference/update-claude-docs.sh, computes diffs, and reports impacts on the skill validator, plugins, and project documentation. Use when user mentions "sync docs", "update reference docs", "refresh docs", or "check doc changes".

View SKILL.md on GitHub Repository
Stars 9
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/joaquimscosta/arkhe-claude-plugins/tree/main/.claude/skills/sync-docs

SKILL.md

Sync Docs

Sync official Anthropic documentation into docs/reference/ and produce an impact analysis report.

Quick Start

Run the sync and diff script:

bash
scripts/sync_and_diff.py

Preview changes without overwriting:

bash
scripts/sync_and_diff.py --dry-run

Execution

Phase 1: Sync & Diff

  1. Execute scripts/sync_and_diff.py (or with --dry-run if $ARGUMENTS contains --dry-run)
  2. Parse the JSON output from stdout
  3. Display a summary table of changed/unchanged files

Phase 2: Impact Analysis

For each changed file, perform the following analysis. See WORKFLOW.md for detailed steps.

2a. Skill Validator Impact (CRITICAL priority)

Check discrepancies in the JSON output:

  • skill_frontmatter_keys.in_docs_not_validator (CRITICAL): New fields in SKILLS.md the validator will reject as unknown (FM009). Report exact fields and line in validate_skill.py to update (ALLOWED_FRONTMATTER_KEYS, ~line 151).
  • skill_frontmatter_keys.in_validator_not_docs (WARNING): Fields the validator allows but SKILLS.md no longer documents. May be from SUBAGENTS.md (valid for context: fork) or deprecated.
  • subagent_frontmatter_keys (INFO): New subagent fields from SUBAGENTS.md. Not all are valid in skill frontmatter — report for context. Only flag fields that overlap with skill usage (e.g., maxTurns, mcpServers, memory, skills).
  • hook_events.in_docs_not_validator (CRITICAL): New hook events the validator will reject (HK001). Report the line to update (VALID_HOOK_EVENTS, ~line 1021).
  • hook_events.in_validator_not_docs (WARNING): Hook events the validator knows but docs no longer list.
  • memory_scopes: Review manually if SUBAGENTS.md changed — check if memory scope options expanded.

2b. Plugin Component Impact (WARNING priority)

For each changed synced doc, identify the conceptual areas that changed (new fields, deprecated features, renamed concepts). Then:

  1. Use Grep to search plugins/*/ for references to changed concepts
  2. Flag plugins using deprecated patterns
  3. Note new capabilities not yet leveraged (as INFO)

2c. Project Documentation Impact (WARNING priority)

Check these files for stale references to synced doc content:

  • CLAUDE.md — Plugin Component Guidelines section, Key Documentation Files section
  • docs/README.md — Synced Documentation section, learning paths
  • docs/SKILL_DEVELOPMENT_BEST_PRACTICES.md — Frontmatter reference, patterns

Output Format

Present findings as a structured report:

=== Documentation Sync Impact Report ===

## Sync Summary
| File | Status | +Lines | -Lines | New Sections | Removed Sections |
|------|--------|--------|--------|--------------|-----------------|
...

## CRITICAL: Skill Validator Updates Required
(List each discrepancy with file, line number, and fix)

## WARNING: Plugin Components Affected
(List affected plugins and what changed)

## WARNING: Project Documentation Stale
(List affected doc files and what to update)

## INFO: New Capabilities Available
(List new features from updated docs that could be leveraged)

If no files changed, report: "All documentation is up to date. No impacts detected."

References

  • WORKFLOW.md — Detailed impact analysis steps
  • EXAMPLES.md — Example report outputs
  • TROUBLESHOOTING.md — Common issues

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

joaquimscosta/arkhe-claude-plugins

Skill Name

What this skill does. Use when user mentions "keyword1", "keyword2", or "keyword3". Keep under 1,024 characters and include specific trigger keywords.

9 1
Explore
joaquimscosta/arkhe-claude-plugins

plugin-release-checker

9 1
Explore
joaquimscosta/arkhe-claude-plugins

skill-validator

Validate skills against Anthropic best practices for frontmatter, structure, content, file organization, hooks, MCP, and security (62 rules in 8 categories). Use when creating new skills, updating existing skills, before publishing skills, reviewing skill quality, or when user mentions "validate skill", "check skill", "skill best practices", "skill review", or "lint skill".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

research-frontmatter

Enforce standard YAML frontmatter on research documents in docs/research/. Use when creating, editing, or promoting research files, when user mentions "research metadata", "research frontmatter", or "research staleness".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

deep-research

Deep research on technical topics using EXA tools with intelligent two-tier caching. Use when user asks to research a topic, investigate best practices, look up information, find patterns, or explore architectures. Also invoked by /research command. Triggers: "research", "look up", "investigate", "deep dive", "find information about", "what are best practices for", "how do others implement".

9 1
Explore
joaquimscosta/arkhe-claude-plugins

workflow-orchestration

Coordinate structured thinking and multi-agent parallel execution for complex tasks. Use when tackling multi-step projects, planning parallel work, breaking down complex problems, coordinating specialist tasks, facing architectural decisions, or when user mentions "workflow", "orchestration", "multi-step", "coordinate", "parallel execution", "structured thinking", "break this down", "plan this out", "how should I approach", or needs help planning complex implementations.

9 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results