Section Draft
Purpose
Produce - or revise the wording of - the cited first-draft language for a section the plan has marked ready.
When to use
Use after section-plan, once a section is marked ready, when a user says things like:
- "Draft the Synopsis from our locked tables."
- "Write the efficacy evaluation section."
- "Give me a first pass at the discussion."
- "Write up safety from Table 14.3.1."
- "Draft the device description for the 510(k)."
- "Tighten the wording of the Discussion - it reads clunky." (a revision: prose changes, asserted values do not)
When NOT to Use
Do NOT use when:
- The section is still
blocked-on-missing-fact - use source-ingest to source the fact first; drafting against a
gap is how invented numbers enter a submission. Use section-plan to confirm readiness instead.
- The ask is to change a figure a reviewer disputes, or to make two sections agree - that is an open item for
consistency-check to report, not a drafting decision - run consistency-check instead.
- The ask is to check or assemble rather than write - use consistency-check or submission-assemble instead.
- The document is not a regulatory submission section (appeal letter, clinical note, discharge summary, general
business document) - use the relevant HLS plugin or the built-in docx skill instead.
- The user asks for a number "roughly", "about" or "close enough" - decline and quote the source value.
Inputs
source_facts (each {value, citation}, keyed per config/field-dictionary.json); the section plan entry for this
section; the target section's name from config/submission-templates.json; config/style-guide.json. For a
revision, the existing draft_sections entry.
Steps
Tool: read inputs with the file-read tool; after drafting, hand the payload to consistency-check, which runs
python3 base/scripts/consistency_check.py --question <payload.json> --out <report.json> with the bash tool.
- Confirm the section is marked
ready in the plan; if it is blocked, stop and return it to source-ingest.
- Draft (or, for a revision, rewrite) the narrative prose for the section. A revision may change wording only -
every asserted value, and its citation, stays exactly as it was.
- For every number, date and population definition the prose asserts, copy the value verbatim from source_facts
into
draft_sections[].asserted under the same key (submission-rules.md #1 and #4) - never re-derive, round or
recompute it, and never compute a percentage or ratio the fact map does not hold.
- Carry the source fact's citation onto each asserted value unchanged; the engine compares the two strings
(submission-rules.md #5).
- Keep "enrolled", "randomized", "completed" and "safety population" strictly distinct, exactly as the SAP defines
them, even where the counts look interchangeable (submission-rules.md #2; enforced from
config/style-guide.json
population_terms_must_match_sap). If the source figures look anomalous (for example a
subset count larger than its parent population), add a reviewer note naming both values - never reconcile them.
- Emit the section in the output format below and hand off to consistency-check - drafting is never the last hop.
Output
A draft_sections entry on the contract with section, status: "drafted", the narrative string and the
asserted map, plus the prose for the reviewer headed "DRAFT - for medical writer / biostatistician review; not
approved", with an inline [source] marker after each quantitative claim and a markdown list of open items (facts
the section needed but could not source) and reviewer notes.
Output Format
{"section": "Safety Evaluation", "status": "drafted",
"narrative": "The safety population comprised 259 subjects [TLF Table 14.1.1 - Subject disposition]. ...",
"asserted": {"safety_population_n": {"value": 259, "citation": "TLF Table 14.1.1 - Subject disposition"},
"teae_subjects_n": {"value": 201, "citation": "TLF Table 14.3.1 - Treatment-emergent adverse events"}}}
Open items: - incidence percentages by arm: not in source_facts - route to source-ingest.
Grounding requirements
Every asserted value is copied verbatim from source_facts, never re-derived, rounded, averaged or estimated by the
model (config/style-guide.json numeric_format). Never fabricate a number, date, population definition, citation
or result - not to fill a sentence, not to make prose flow, and not because a plausible value is obvious. If the
fact is not in source_facts it is not written; it is raised as an open item. Narrative prose may summarise, but
every quantitative claim must be one of the cited asserted values. Rules: base/references/submission-rules.md #1,
#2, #4, #5.
Constraints
Guardrails
Guardrails for this skill:
- Action level L1: produces a draft for human approval; nothing is filed, sent or transmitted.
- Never assert a number that does not appear in source_facts - the engine reports it as an unsourced assertion and
it is never a silent pass (submission-rules.md #4).
- Never assert a value without its citation, even when the prose is asked to read "clean": the prose may omit
citation markers, the contract may not (submission-rules.md #5).
- Never silently correct, harmonise or round a figure so two sections agree - that is reported, not fixed
(submission-rules.md #1).
- Never substitute one population count for another, however close the numbers (submission-rules.md #2).
- Never include subject-level identifiers (IDs, initials, dates of birth) - source_facts is aggregate only.
- Never decide or calculate a numeric result; the model drafts language only.
- Never present a draft as final, approved or reviewed.
Escalation / uncertainty
If a section needs a fact that is not in source_facts, mark it as an open item and route it back to source-ingest
rather than inventing a plausible value. If a user presses for a figure to be adjusted, restate both values with
their citations and escalate to the medical writer / biostatistician.
Error Handling
- Section not in the plan, or plan missing: stop and ask for section-plan to run first.
- Section name not in config/submission-templates.json for the submission type: stop - the structure comes from
config, never from the model.
- consistency-check reports findings on the new draft: return them to the user unchanged; do not redraft numbers to
make the findings go away.
1---2name: section-draft3description: >-4 Write or revise the language for one planned CSR or 510(k) section - synopsis, efficacy, safety, discussion,5 device description - using only figures already in the cited fact map, each with its TLF or SAP citation.6 Use when the user asks "draft the Synopsis from our locked tables", "write up safety from Table 14.3.1",7 "give me a first pass at the discussion", "draft the device description for the 510(k)" or "tighten the8 wording of the Discussion section". Do NOT use for supplying a number not already in source_facts - use9 source-ingest instead. Do NOT use for verifying a draft's figures - use consistency-check instead. Do NOT use10 for appeal letters, clinical notes or discharge summaries - use the matching HLS plugin instead. Guardrail:11 drafts for human approval only (L1); never asserts an unsourced number or harmonises two figures.12license: MIT13metadata:14 source: https://skillmd.com/skills/microsoft/section-draft15 version: 1.0.316 author: Microsoft Healthcare & Life Sciences Skills17 category: writing18 domain: Pharma / MedTech Regulatory & Quality19 action_level: L120 icon: Compose21---2223# Section Draft24## Purpose25Produce - or revise the wording of - the cited first-draft language for a section the plan has marked ready.26## When to use27Use after section-plan, once a section is marked `ready`, when a user says things like:28- "Draft the Synopsis from our locked tables."29- "Write the efficacy evaluation section."30- "Give me a first pass at the discussion."31- "Write up safety from Table 14.3.1."32- "Draft the device description for the 510(k)."33- "Tighten the wording of the Discussion - it reads clunky." (a revision: prose changes, asserted values do not)34### When NOT to Use35Do NOT use when:36- The section is still `blocked-on-missing-fact` - use source-ingest to source the fact first; drafting against a37 gap is how invented numbers enter a submission. Use section-plan to confirm readiness instead.38- The ask is to change a figure a reviewer disputes, or to make two sections agree - that is an open item for39 consistency-check to report, not a drafting decision - run consistency-check instead.40- The ask is to check or assemble rather than write - use consistency-check or submission-assemble instead.41- The document is not a regulatory submission section (appeal letter, clinical note, discharge summary, general42 business document) - use the relevant HLS plugin or the built-in docx skill instead.43- The user asks for a number "roughly", "about" or "close enough" - decline and quote the source value.44## Inputs45`source_facts` (each `{value, citation}`, keyed per config/field-dictionary.json); the section plan entry for this46section; the target section's name from `config/submission-templates.json`; `config/style-guide.json`. For a47revision, the existing `draft_sections` entry.48## Steps49Tool: read inputs with the file-read tool; after drafting, hand the payload to consistency-check, which runs50`python3 base/scripts/consistency_check.py --question <payload.json> --out <report.json>` with the `bash` tool.511. Confirm the section is marked `ready` in the plan; if it is blocked, stop and return it to source-ingest.522. Draft (or, for a revision, rewrite) the narrative prose for the section. A revision may change wording only -53 every asserted value, and its citation, stays exactly as it was.543. For every number, date and population definition the prose asserts, copy the value verbatim from source_facts55 into `draft_sections[].asserted` under the same key (submission-rules.md #1 and #4) - never re-derive, round or56 recompute it, and never compute a percentage or ratio the fact map does not hold.574. Carry the source fact's citation onto each asserted value unchanged; the engine compares the two strings58 (submission-rules.md #5).595. Keep "enrolled", "randomized", "completed" and "safety population" strictly distinct, exactly as the SAP defines60 them, even where the counts look interchangeable (submission-rules.md #2; enforced from61 config/style-guide.json `population_terms_must_match_sap`). If the source figures look anomalous (for example a62 subset count larger than its parent population), add a reviewer note naming both values - never reconcile them.636. Emit the section in the output format below and hand off to consistency-check - drafting is never the last hop.64## Output65A `draft_sections` entry on the contract with `section`, `status: "drafted"`, the `narrative` string and the66`asserted` map, plus the prose for the reviewer headed "DRAFT - for medical writer / biostatistician review; not67approved", with an inline `[source]` marker after each quantitative claim and a markdown list of open items (facts68the section needed but could not source) and reviewer notes.69### Output Format70```json71{"section": "Safety Evaluation", "status": "drafted",72 "narrative": "The safety population comprised 259 subjects [TLF Table 14.1.1 - Subject disposition]. ...",73 "asserted": {"safety_population_n": {"value": 259, "citation": "TLF Table 14.1.1 - Subject disposition"},74 "teae_subjects_n": {"value": 201, "citation": "TLF Table 14.3.1 - Treatment-emergent adverse events"}}}75```76Open items: - incidence percentages by arm: not in source_facts - route to source-ingest.77## Grounding requirements78Every asserted value is copied verbatim from source_facts, never re-derived, rounded, averaged or estimated by the79model (config/style-guide.json `numeric_format`). Never fabricate a number, date, population definition, citation80or result - not to fill a sentence, not to make prose flow, and not because a plausible value is obvious. If the81fact is not in source_facts it is not written; it is raised as an open item. Narrative prose may summarise, but82every quantitative claim must be one of the cited asserted values. Rules: base/references/submission-rules.md #1,83#2, #4, #5.84## Constraints85### Guardrails86Guardrails for this skill:87- Action level L1: produces a draft for human approval; nothing is filed, sent or transmitted.88- Never assert a number that does not appear in source_facts - the engine reports it as an unsourced assertion and89 it is never a silent pass (submission-rules.md #4).90- Never assert a value without its citation, even when the prose is asked to read "clean": the prose may omit91 citation markers, the contract may not (submission-rules.md #5).92- Never silently correct, harmonise or round a figure so two sections agree - that is reported, not fixed93 (submission-rules.md #1).94- Never substitute one population count for another, however close the numbers (submission-rules.md #2).95- Never include subject-level identifiers (IDs, initials, dates of birth) - source_facts is aggregate only.96- Never decide or calculate a numeric result; the model drafts language only.97- Never present a draft as final, approved or reviewed.98## Escalation / uncertainty99If a section needs a fact that is not in source_facts, mark it as an open item and route it back to source-ingest100rather than inventing a plausible value. If a user presses for a figure to be adjusted, restate both values with101their citations and escalate to the medical writer / biostatistician.102### Error Handling103- Section not in the plan, or plan missing: stop and ask for section-plan to run first.104- Section name not in config/submission-templates.json for the submission type: stop - the structure comes from105 config, never from the model.106- consistency-check reports findings on the new draft: return them to the user unchanged; do not redraft numbers to107 make the findings go away.