bjornmelin/docs-align
skills/docs-align/SKILL.md
Align docs with code. Detect drift and update ADRs, specs, README, AGENTS. Use after implementation or for docs drift reviews. Not for code review fixes or platform architecture.
$ install --global
skillsauthnpx skillsauth add bjornmelin/dev-skills docs-alignInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:43 AM136.1s4 files scanned
SKILL.md
- name:
- docs-align
- description:
- Align docs with code. Detect drift and update ADRs, specs, README, AGENTS. Use after implementation or for docs drift reviews. Not for code review fixes or platform architecture.
Docs Align
Use this skill after implementation work or when you suspect documentation drift.
Workflow
- Read the repo
AGENTS.md. - From this skill root (directory containing
SKILL.md), run drift collection (requiresgiton PATH):python3 scripts/docs_drift.py collect --cwd <repo> --out <json>- Equivalent collect-only shortcut:
python3 scripts/check_docs_drift.py --cwd <repo> --out <json>
python3 scripts/docs_drift.py compare --input <json> --out <json>- Render the summary:
python3 scripts/docs_drift.py render --input <json> --format md
- Use Alignment policies below only for doc surfaces that the gap map says are in scope.
- Update docs only after the gap map is clear.
Path note
Commands above assume the current working directory is this skill’s root (skills/docs-align in this repository). If the working directory is elsewhere, invoke the same files with an absolute path, for example:
python3 /path/to/docs-align/scripts/docs_drift.py collect --cwd <repo> --out <json>
Alignment policies
ADR
Create or update an ADR when the implementation changed:
- architecture boundaries
- execution model
- durable workflow policy
- major dependencies or infrastructure choices
Do not create ADR churn for small local refactors.
Spec
Update product or architecture specs when the implementation changed:
- interfaces
- contracts
- verification steps
- operational behavior
Prefer deleting stale spec text over leaving contradictory guidance.
README
Update the README when the change affects:
- setup
- commands
- environment variables
- high-level architecture or usage expectations
Keep the README high signal; move deep details into docs when needed.
Use When
- The task is post-implementation doc alignment.
- The user wants README, ADR, spec, or AGENTS updates based on code changes.
Do Not Use When
- The task is only code review remediation.
- The task is only dependency planning.
Outputs
- likely impacted docs
- missing/update/delete doc tasks
- a concise docs alignment summary
Related Skills
bjornmelin/kimi-ui-advisor
tools
VerifiedTrustedCommunity
Explicit-only Kimi Code CLI frontend/UI advisor for UI audits, redesigns, components, screenshots, before/after comparison, layout, styling, accessibility, responsive behavior, and visual polish. Use only when the user explicitly invokes `$kimi-ui-advisor` and wants Codex to ask Kimi for structured UI suggestions, then review, apply, and verify them in the repo.
2SKILL.mdUpdated May 28, 2026
bjornmelin/autoreview
development
VerifiedTrustedCommunity
Run a Codex-only structured code review closeout for local, branch, or commit diffs. Use when the user asks for autoreview, Codex review, structured closeout review, final review before commit/ship, or review after non-trivial code edits.
2SKILL.mdUpdated May 28, 2026
bjornmelin/firecrawl
tools
VerifiedTrustedCommunity
Use this skill for Firecrawl CLI web work: web search, URL scraping, site mapping, crawling, structured extraction, page interaction, monitoring changes, offline site download via x download, and parsing local documents such as PDF, DOCX, XLSX, HTML, DOC, ODT, or RTF. Trigger for requests to search the web, look up current info, fetch/read/scrape a URL, extract website data, crawl docs, click/fill/login/paginate a page, monitor page changes, save a site offline, or parse a document. Do not trigger for generic local file reads/edits, git/deploy/code tasks, or Firecrawl app integration work.
2SKILL.mdUpdated May 26, 2026
bjornmelin/sentry-triage-to-pr
tools
VerifiedTrustedCommunity
Triage unresolved Sentry issues into ranked groups, GitHub issue plans, branches, subspawn worktree assignments, PRs, and closeout loops using the sentry CLI, GitHub CLI, and local verification. Use when asked to prioritize Sentry backlogs, group production issues, create GitHub issues or PRs from Sentry evidence, or parallelize Sentry fixes.
2SKILL.mdUpdated May 14, 2026