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.md
View on GitHub---
title: Deploying The Widget Service To Production Using Our Standard Pipeline
description: A walkthrough of the deployment pipeline.
author: Docs Team
date: 2026-07-14
---
# Deploying the widget service
The widget service is deployed by the release pipeline whenever a tag is pushed
to the default branch. This guide explains the pipeline stages and the manual
approval gate.
### Prerequisites
Before you begin, it should be confirmed by the reader that access has been
granted to the deployment console, that the required credentials were rotated
within the last ninety days, and that the change record was filed with the
platform team at least one full business day before the intended release window
so that the on-call rotation can be notified in advance of any disruption.
Access is requested through the internal portal. See
[click here](https://internal.example.com/access) to open a request.
## Installation
Install the command line client on your workstation.
```bash
npm install --global widget-cli
widget-cli auth login
```
The client is written in Javascript and talks to the backend over gRPC. The
frontend console is a separate application and is not required for deployment.

## Pipeline Stages
The pipeline has four stages. Each stage is gated by the previous one.
| Stage | Owner | Duration |
| Build | Platform | 4 min |
| Test | QA | 11 min |
| Stage | Platform | 6 min |
| Deploy | Release manager | 3 min |

Detailed timings are maintained in the
[pipeline runbook](./missing-runbook.md).
## rollback procedure
If a deploy fails, the previous revision is restored automatically by the
controller within ninety seconds, and an e-mail is sent to the release channel,
but if the automatic rollback is itself unsuccessful because the previous
revision has already been garbage collected by the registry retention policy
then a manual restore must be performed by the on-call engineer using the
archived image bundle stored in cold storage.
Read the [prerequisites](#missing-prerequisites) again before retrying.
See the [installation section](#installation) for client setup, and the
[review configuration](./sample_review_config.json) for gate thresholds.
# Appendix
Additional notes are published on the [project web site](https://example.com/docs)
and mirrored on our Github organisation page.
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 |