borghei/Claude-Skills / markdown-html/md-review
md-review
VerifiedPre-publication quality gate for authored Markdown — heading structure, on-disk link resolution, readability, accessibility, terminology. Use when reviewing docs before publishing, wiring a docs CI gate, or auditing a Markdown corpus.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.1 KB |
| assets/review_report_template.md | markdown | 4.3 KB |
| assets/sample_article.md | markdown | 2.4 KB |
| assets/sample_article_clean.md | markdown | 1.8 KB |
| assets/sample_review_config.json | config | 2.4 KB |
| references/readability-accessibility-and-terminology.md | markdown | 17.7 KB |
| references/review-rulebook-and-severity-model.md | markdown | 20.5 KB |
| scripts/link_checker.py | script | 11.9 KB |
| scripts/md_review_gate.py | script | 15.8 KB |
| scripts/readability_scorer.py | script | 14.1 KB |
assets/sample_article_clean.md
View on GitHub---
title: Rotating service credentials
description: How to rotate the widget service credentials on the ninety-day cycle.
author: Docs Team
date: 2026-07-14
tags:
- security
- operations
---
# Rotating service credentials
Every widget service credential expires after ninety days. This guide shows how
to rotate one before it expires. Plan for about ten minutes of work.
## Before you start
You need console access and a filed change record. Ask the platform team if you
are missing either one. Both take a day to arrange, so start early.
## Rotate the credential
Install the client first. Then run the rotate command against the target
environment.
```bash
npm install --global widget-cli
widget-cli auth login
widget-cli creds rotate --env production
```
The command prints a new secret. Copy it into the vault right away. The old
secret stays valid for one hour, which gives you time to update consumers.

## Verify the change
Check that every consumer picked up the new secret. The dashboard lists each
consumer and the secret version it holds.
| Consumer | Expected version | Check interval |
| --- | --- | --- |
| API gateway | v4 | 60 seconds |
| Job runner | v4 | 5 minutes |
| Reporting job | v4 | 1 hour |
If a consumer still holds the old version after an hour, restart it. See the
[rotate the credential](#rotate-the-credential) steps above to confirm you
copied the right secret.
## If something breaks
Roll back with the previous secret from the vault. The vault keeps the last
three versions. File an incident note and tell the on-call engineer.
Full reference material lives in the
[review configuration file](sample_review_config.json) and on the
[public documentation site](https://example.com/docs).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |