check-docs-drift - Detect and sync polkadot-docs tutorial drift and dependency versions
Scans polkadot-docs README files for upstream commit drifts, classifies diffs as cosmetic or substantive, auto-bumps cosmetic changes, creates GitHub issues for substantive drifts, and syncs dependency versions from upstream variables.yml.
Tags
Updated: 2026-06-30Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Scan polkadot-docs README files
- Extract pinned commit from frontmatter
- Compare pinned commits with upstream
- Fetch diff patches via GitHub API
- Classify diffs as cosmetic or substantive
- Auto-bump cosmetic drifts in READMEs
- Create GitHub issue for drifts
- Sync dependency versions from upstream
- Update package.json and lockfiles
- Generate run report with metrics
Inputs
- polkadot-docs README files
- versions.yml file
- Upstream variables.yml from polkadot-docs repo
- package.json files in harness directories
- GitHub API access token
Outputs
- Updated README files with bumped docs_commit
- Updated versions.yml
- Updated package.json files
- Regenerated package-lock files
- GitHub issue with drift report
- Run report with phase metrics
Requirements
- GitHub CLI installed and authenticated
- npm installed for lockfile regeneration
- Git push permissions to repository
- Read access to polkadot-developers/polkadot-docs repository
- Agent tool support for parallel subagents