ITU-T Recommendation Reviewer

SkillDev tools

Review draft ITU-T Recommendations (and ITU-T | ISO/IEC common texts) for compliance with the ITU-T Author's Guide, presentation rules, and quality checklist before submission for consent/determination/approval. Use this skill whenever the user asks to review, check, audit, proofread, or improve a draft ITU-T Recommendation, standard contribution, amendment, corrigendum, or common text — including requests phrased as "检查/审查/校对 ITU-T 建议书", "does my draft follow ITU-T rules", "prepare my draft for TSB submission", or when a user uploads a document identified as a draft Recommendation. Also use it when authors ask how to correctly structure clauses, references, definitions, figures, tables, or notes in an ITU-T text.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the ITU-T Recommendation Reviewer skill

What this skill tells your AI

The instructions your AI receives, as published by openitu/itu-t-recommendation-reviewer in SKILL.md and read by ahel’s review.

Review draft ITU-T Recommendations against the official drafting rules so that authors, editors, and rapporteurs can fix problems before the text goes to TSB or is proposed for consent/determination/approval. The rules encoded here come from three authoritative sources:

  1. ITU-T Editing Guidelines — Author's guide for drafting ITU-T Recommendations (06/2023) — the primary rulebook for pure ITU-T texts.
  2. Rules for presentation of ITU-T | ISO/IEC common text (09/2014) — overrides the author's guide when the text is a joint ITU-T | ISO/IEC document.
  3. Recommendation ITU-T A.1 (09/2019) — working methods; relevant for terminology (amendment/corrigendum/annex/appendix), work-item context, and submission expectations.
  4. TSAG LS20 Attachment 1 — draft "Checklist for draft ITU-T Deliverables" (TSAG-C48, Geneva, Jan 2026) — the rapporteur-meeting readiness checklist circulated by TSAG to all SGs. Status: draft (under SG consultation); apply it, but attribute its findings to the draft checklist, not to the Author's guide, unless the guide independently requires the same thing.

Step 0 — Identify the document type FIRST

The applicable rulebook depends on the document type. Misidentifying it produces wrong review findings, so always classify before reviewing:

TypeHow to recognize itRulebook
Pure ITU-T RecommendationSingle ITU-T number (e.g., ITU-T X.1234); "Appendix I/II…" for non-integral materialAuthor's guide → references/structure-rules.md + references/formatting-rules.md
ITU-T | ISO/IEC common textDual designation "Rec. ITU-T x.nnn | ISO/IEC nnnnn"; expression "this Recommendation | International Standard"; non-integral annexes instead of appendicesCommon-text rules → references/common-text-rules.md (it deviates from the author's guide; apply its rules where they differ)
Amendment / CorrigendumTitle contains "Amendment n" or "Corrigendum n" to a base textreferences/structure-rules.md §Amendments plus common-text Annex C if it is a common text

If the type is ambiguous, ask the user (one question) rather than guessing.

Step 1 — Load the rules

Read the reference files relevant to the document type before making findings. Do not review from memory alone — the reference files contain the exact boilerplate wording, numbering conventions, and checklist items that findings must cite.

  • references/structure-rules.md — mandatory elements, their order, clause-by-clause requirements (Scope, References, Definitions, Abbreviations, Conventions), annex/appendix rules, required boilerplate sentences.
  • references/formatting-rules.md — fonts, clause numbering, lists, equations, figures, tables, notes/footnotes, citation style, shall/must usage.
  • references/definitions-rules.md — the full best-practice rules for writing definitions (structure, conciseness, independence, grammatical form, formatting).
  • references/common-text-rules.md — everything that differs for ITU-T | ISO/IEC joint texts.
  • references/quality-checklist.md — the rapporteur's pre-approval checklist (Annex D) that every draft must pass, plus A.1-derived process checks.
  • references/rapporteur-meeting-checklist.md — the TSAG LS20 draft RM checklist (items S1, R1–R4, D1–D3, C1–C2, M1–M8): scope↔body alignment, normative-reference usage, definition reusability, conventions actually used, figure legends, architecture-vs-framework figures, feasibility of mandatory requirements.

Step 2 — Run the review in passes

Review in this order; each pass has its own section in the report. Quote or pinpoint the exact location (clause number, figure/table number — never page number) for every finding.

Pass 1 — Skeleton & mandatory elements. Verify presence and correct order of: title, Summary, Keywords, (optional Introduction), Scope (clause 1), References (clause 2), Definitions (clause 3, split 3.1/3.2), Abbreviations and acronyms (clause 4), Conventions (clause 5), technical content (clause 6 onwards), Annexes, Appendices, Bibliography. Empty clauses must say "None." or "This clause is intentionally left blank." — they may not simply be absent.

Pass 2 — Boilerplate & wording conformance. Check that clauses 2, 3.1, 3.2, and 4 open with the exact required sentences (given verbatim in references/structure-rules.md), that annexes/appendices carry the correct "(This annex forms an integral part…)" line, and that "shall"/"must" appear only where a genuinely mandatory provision is intended.

Pass 3 — References & citations. Every entry in clause 2 must be normatively cited in the body (a reference cited only from an appendix is a violation); informative sources belong in the Bibliography with b- citation tags; check citation-tag format [ITU-T A.5] / [b-ITU-T A.13], presentation format of each entry, and cross-reference style ("see clause 5.4.7", "see Figure 1 of [b-ITU-T A.8]").

Pass 4 — Definitions & abbreviations. Apply references/definitions-rules.md item by item: term–class–characteristics structure, no circularity, alphabetical order, bold lower-case term + colon, definitions end with a period, existing terms not redefined. Abbreviations: alphabetical, capitalized letters expanded, first use in text preceded by full form, plural as "ICTs" not "ICTS".

Pass 5 — Figures, tables, equations, notes. Numbering schemes, caption placement (figure titles below/centred; table titles above/centred), explicit in-text reference to every figure and table, note formats ("NOTE – " / "NOTE 1 – "), footnote rules, notes-to-tables placed inside the table frame, equation numbering, SI units, thousand separator as single quote.

Pass 6 — Quality checklist & language. Walk through references/quality-checklist.md: no case studies in normative parts, minimal options, no conflict with approved Recommendations, spell-check, all acronyms (including in figures/tables) expanded, unnecessary capitalization/italics/bold avoided, title contains no acronyms and does not repeat series titles.

Pass 7 — Rapporteur-meeting readiness. Walk through references/rapporteur-meeting-checklist.md (items S1, R1–R4, D1–D3, C1–C2, M1–M8). This pass goes beyond presentation into content organization: Scope elements all treated in the body (and Scope stable at decision stage — otherwise recommend postponement), clause-2 references cited normatively after clause 6 (clause-3-only citation → Bibliography), no general terms in 3.2 and 3.2 terms reusable, every clause-5 convention keyword actually used, every figure's technical terms explained in the text, shapes/lines defined via legend or clause 5, "functional architecture" figures showing connection lines (else rename to framework), positional logic of framework elements stated, mandatory-requirement load feasible, and the draft's difference from existing Recommendations made explicit. Skip items already settled by an earlier pass — cross-reference instead of duplicating.

Step 3 — Write the review report

ALWAYS use this exact report structure (deliver in the user's working language; keep quoted rule text and suggested replacement text in English, since that is the publication language):

# ITU-T Draft Review Report: <document title/number>

## 1. Document profile
Type (pure ITU-T / common text / amendment / corrigendum), rulebook applied, overall verdict:
READY / MINOR REVISION / MAJOR REVISION.

## 2. Critical issues (block consent/approval)
Numbered list. Each item: [Location] — problem — governing rule (cite the guide clause,
e.g., "Author's guide §8.2") — concrete fix (give replacement text where possible).

## 3. Major issues (must fix before publication)
Same format.

## 4. Minor / editorial issues
Same format; may be grouped (e.g., "12 instances of 'may not' — replace with 'need not'").

## 5. Checklist result
Two tables:
(a) the Annex D checklist — item | pass/fail/N-A | evidence;
(b) the TSAG LS20 draft RM checklist (S1, R1–R4, D1–D3, C1–C2, M1–M8), preceded by its
review-summary header (date, document, reviewer, result: "Need further modifications" /
"Need judgement") — item | Yes/No/N-A | evidence. Label table (b) as based on the DRAFT
checklist circulated via TSAG LS20.

## 6. Suggested next steps
Short prose paragraph: what to fix first, and any process reminders from ITU-T A.1
(e.g., IPR declaration, six-week TD deadline, new-work-item template).

Severity calibration:

  • Critical — missing mandatory element, wrong/missing boilerplate, normative reference never cited in the body, appendix mislabelled as annex (or vice versa), "shall" in notes/introductory material, common-text rules violated in a joint text.
  • Major — defective definitions, incorrect reference presentation format, figures/tables never referenced in text, wrong numbering scheme, title violations.
  • Minor — typography, capitalization, list punctuation, note spacing, style-guide deviations.

Step 4 — Offer follow-through

After the report, offer (do not do unsolicited): (a) produce a corrected version of specific clauses with revision marks — remembering the Annex A/E rule that changes must be shown with revision marks and unchanged text may be replaced by ellipses; (b) rewrite the worst definitions; (c) generate the missing boilerplate ready to paste.

Scope limits — be honest about them

  • This skill checks drafting/presentation compliance and internal consistency, not technical correctness of the standard's subject matter. Say so in the report.
  • Word-template styles (exact fonts/point sizes) can only be verified if the user supplies a .docx; from a PDF or pasted text, flag them as "not verifiable from this format" rather than guessing.
  • Never claim a draft "will be approved" — approval is a membership decision under WTSA Res. 1; the verdict wording is about editorial readiness only.

Signals

GitHub stars
23
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
itu-t-recommendation-reviewer
Source
github.com/openitu/itu-t-recommendation-reviewer