| name | aviation-sms-builder |
| description | Build an ICAO Annex 19 four-pillar Safety Management System (SMS) manual — Safety Policy & Objectives, Safety Risk Management, Safety Assurance, Safety Promotion — scoped to a named aircraft operator, airport, or approved maintenance/training organisation, plus the SPI/SPT framework and just-culture policy it frames. Use this skill to build or review an aviation SMS manual, align an SMS to a State Safety Programme (the DGCA SSP in India), or structure an SMS-acceptance submission. Grounds every pillar in KB-STD-ICAO-ANNEX19, aligns the India layer to KB-REG-IN-DGCA, names the Accountable Manager and Safety Manager, forces operator/operation specificity, and ranks every risk mitigation through the hierarchy of controls. Decision-support only; a competent person (aviation SME) must review the output. |
| license | Apache-2.0 |
| metadata | {"author":"eyekyam","version":"1.0","category":"governance","tier":1,"audience":["M","E","C"],"industry":["Avi"],"jurisdiction":["All"],"status":"stable","plugin":"hse-aviation","hse_reviewed_by":"","hse_reviewed_date":""} |
Aviation SMS Builder
The ICAO Annex 19 SMS flagship (catalog #36). Given a named aircraft operator, airport, or approved maintenance/training organisation, it builds a four-pillar Safety Management System manual — Safety Policy & Objectives · Safety Risk Management · Safety Assurance · Safety Promotion — and frames the SPI/SPT framework and just-culture policy that sit inside it. Every pillar grounds in KB-STD-ICAO-ANNEX19; where the jurisdiction is India the manual aligns to the DGCA State Safety Programme (KB-REG-IN-DGCA). It names the Accountable Manager and Safety Manager, forces operator/operation specificity (a generic "aviation SMS manual" is exactly the indefensible copy-paste output this skill exists to prevent), and ranks every risk mitigation through the hierarchy of controls — never a vague, PPE/admin-only treatment.
When to use this skill
Use this skill when the user needs an SMS manual built or reviewed for a named operator/airport/AMO, an SMS aligned to a State Safety Programme (DGCA SSP in India / FAA / EASA), or an SMS-acceptance submission structured to the four Annex 19 pillars. Trigger phrases: "build our SMS manual", "ICAO Annex 19 safety management system", "align our SMS to the DGCA SSP", "draft our safety policy and accountabilities". If the request is vague ("improve our safety"), the Workflow intake forces the operator, the operation type, and the jurisdiction first. It builds the SMS manual; the deeper artifacts it frames are separate skills — the hazard register (aviation-hazard-register), the SPI/SPT detail (aviation-spi-spt-framework), the just-culture policy (aviation-just-culture-policy), and the confidential-reporting design (aviation-confidential-reporting).
Data Protection & De-identification (MANDATORY — apply before drafting)
Apply this BEFORE you draft anything. Treat injury, illness, and any health
detail as the highest sensitivity. Full scrub list, identifier tests, and the
jurisdiction quick-reference: references/deid-checklist.md.
- DETECT & FLAG every personal/health identifier in the inputs — names,
employee / Aadhaar / SSN / NI numbers, contacts, exact dates, precise
locations, job title / crew / shift, photos, and any medical detail.
List what you found before drafting. If unsure whether something is
identifying, treat it as identifying.
- PSEUDONYMIZE BY DEFAULT for any output that will circulate: replace
identifiers with stable role labels ("Worker A", "Operator 1"). Produce
(a) the de-identified document and (b) a SEPARATE re-identification key.
Never put the key or any name↔label mapping in the document. Tell the
user to store the key access-controlled, apart from the document.
- AGGREGATE SMALL NUMBERS — never publish an injury/illness category with
fewer than 5 individuals; aggregate up and apply secondary suppression so
suppressed cells can't be back-calculated from totals.
- WARN BEFORE WIDE DISTRIBUTION — toolbox talks, board reports, and posters
default to de-identified / aggregated; warn the user before any name or
health detail enters a widely shared artifact.
- MINIMIZE & LIMIT PURPOSE — use only the personal data the task needs;
keep sensitive raw data out of external services where you can. When in
doubt, ask before including it.
Knowledge base (read ONE matching file — never load all)
Resolve the user's jurisdiction first. Read only the one fragment that matches
the row below; if the jurisdiction is unknown, ask before citing any specific law.
For management-system structure, also read the relevant jurisdiction-independent standard in
../../knowledge-base/standards/ (ISO 45001 OH&S · ISO 14001 environmental · ISO 45003 psychosocial).
Always apply ../../knowledge-base/prompt-snippets/hierarchy-of-controls.md (KB-SNIP-HOC)
to every control recommendation. For any benchmark/figure, look up the ID in the relevant
_registry.yaml, then read ONLY the named file — and quote its source+year.
| Jurisdiction | Read |
|---|
| Any (SMS framework) | ../../knowledge-base/standards/icao-annex19.md (KB-STD-ICAO-ANNEX19 — the four-pillar clause→artifact map) + prompt-snippets/hierarchy-of-controls.md (KB-SNIP-HOC) |
| India (State Safety Programme) | ../../knowledge-base/regulatory/in-dgca.md (KB-REG-IN-DGCA — align the SMS to the DGCA SSP; CAR number [GAP], never invented) |
| USA / EU (other State programmes) | Ask the user for the FAA / EASA reference; align the four pillars to it (no fabricated clause) |
| Unknown | Ask the operator's certificating authority before citing any State programme |
Workflow
Open with a structured multi-step intake — MCQ where the answer space is enumerable, free-text where it is open. Ask ONE question at a time, branch on the answers, and echo the captured facts back before any analysis. Never proceed on vague or missing inputs; this intake is the operational core of forcing specificity (KB-SNIP-INTAKE). (Intake is a Workflow convention, not a sixth block.)
The full typed/branched intake Q-table — the org type, named scope, the State Safety
Programme / jurisdiction branch (India → KB-REG-IN-DGCA, FAA/EASA → ask-the-reference,
never fabricate), the Accountable Manager + Safety Manager appointments, the
build/review/submission scope, and the audience/distribution gate — lives in
references/intake.md (the intake-coverage manifest + echo-back + refuse-on-vague
anchors). Run it one question at a time, branch on the answers, and echo the confirmed
organisation + scope + jurisdiction + the two appointments back before any drafting. Then walk the four pillars in order (KB-STD-ICAO-ANNEX19): Pillar 1 (policy + accountabilities + key personnel + ERP coordination + SMS documentation), Pillar 2 (the hazard-ID process + the 5×5 RCS reference — point to aviation-hazard-register for the live register), Pillar 3 (the SPI/SPT framework + management review/SRB — point to aviation-spi-spt-framework and aviation-srb-minutes), Pillar 4 (training + just culture + confidential reporting — point to aviation-just-culture-policy and aviation-confidential-reporting). Flag any pillar left incomplete.
Then: validate the draft against references/QUALITY_CHECKLIST.md → produce the output via the Output format section below. The domain method (the four-pillar build) is in references/METHODOLOGY.md.
Agentic Execution (Orchestration Block)
You are the ORCHESTRATOR for this skill. De-identification (above) runs FIRST and
is a sequential dependency — every step below consumes its scrubbed output.
Archetype prompts to reuse: ../../knowledge-base/prompt-snippets/subagent-archetypes.md (KB-SNIP-ARCHETYPES).
Step 0 — Triage: fan out at all?
Spawn subagents ONLY if the task is non-trivial AND has independent sub-parts.
Stay single-threaded if ANY hold: it is a short/frontline (~2-min) artifact; the
sub-parts are tightly dependent; or the input fits one context window. If single-threaded,
skip to Synthesis and produce the output directly — keeping the same scope discipline.
Step 1 — Plan
Decompose into INDEPENDENT jobs. Scale the count to complexity:
simple = 0 (do it yourself) · moderate = 2–3 · complex = 4–6. Never exceed MAX=6.
Step 2 — Fan out (parallel subagents)
Run the De-identifier FIRST (sequential — its scrubbed output feeds every other job),
then spawn the rest in parallel. Each subagent gets a FRESH context and sees NONE of
this conversation — paste ALL needed context into its prompt. Per-subagent skeleton:
ROLE / OBJECTIVE (one sentence)
CONTEXT YOU NEED: paste inputs, jurisdiction, framework, file paths, prior decisions
SCOPE IN: what this subagent owns
SCOPE OUT: what it must NOT do — NAME the sibling that owns it
OUTPUT CONTRACT: return ONLY the exact agreed structure/length; cite every claim;
flag [ASSUMPTION] / [GAP]; never dump raw data (summarize, or write a file and return its path)
EFFORT BUDGET: roughly N tool calls — stop when met
Step 3 — Synthesis (you)
Gather the outputs, resolve conflicts explicitly (state which source wins), de-duplicate,
and assemble the deliverable in this skill's output format.
Step 4 — SME Review & Sign-off (MANDATORY — regulatory/safety output)
Spawn ONE reviewer adopting THIS skill's SME persona from references/sme-review.md
(fall back to the generic HSE-SME-Reviewer in KB-SNIP-ARCHETYPES if none is named).
Give it the draft + the inputs + the output contract. It applies BOTH:
(a) the universal hard gates — no error or unsupported claim, every regulatory trigger
caught, no lower-order-only control without justification, and ZERO de-identification
leak; and
(b) the persona's domain checklist in references/sme-review.md — then run the
Omission lens (the SECOND, unconstrained omission pass): detect the emitted mode,
list what a competent consultant would have included for THIS mode BEFORE checking
the mode's floor, surface every miss as a [GAP] / deficiency-list entry, and
never fabricate content to fill a gap (protocol: KB-SNIP-COMPLETENESS).
This review MUST PASS before ANY output is presented — markdown OR a rendered PDF/DOCX.
Fix everything it raises and re-run until clean. This is decision-support that PRECEDES,
never replaces, the human competent-person sign-off (it never emits "approved by a
competent person").
Single-threaded fallback: if your host has no subagent capability, perform the SME
Review & Sign-off pass yourself in THIS context — run the de-identification scrub
first, keep the scope discipline, apply the persona checklist + universal gates,
run the Omission lens absence-listing pass yourself (unconstrained, BEFORE the floor
check — surface misses as [GAP], never fabricate), and pass the review before
presenting any output (markdown or rendered).
Subagent roster for THIS skill
Moderate fan-out (the De-identifier runs FIRST as a sequential dependency):
- De-identifier — runs FIRST; scrub any named individuals (the Accountable Manager,
Safety Manager, reporters) into role labels before any analysis. Returns the
re-identification key SEPARATELY to the orchestrator, never to a sibling.
- Researcher (pillar-coverage) — from the scrubbed inputs, gather the operator/operation
facts and check the four Annex 19 pillars (
KB-STD-ICAO-ANNEX19) for coverage; flag any
pillar with no input as [GAP].
- Regulatory-Checker (SSP / Annex 19) — for the resolved jurisdiction (India → the DGCA
SSP,
KB-REG-IN-DGCA), confirm the SMS aligns to the State Safety Programme; mark the exact
CAR/clause [GAP] where unverified — never fabricate a CAR number. SCOPE-OUT: does not draft.
- Drafter — assemble the four-pillar SMS manual in the output format, naming the
Accountable Manager + Safety Manager, HoC-ranking every mitigation, tracing every claim to
an input. SCOPE-OUT: does not check the SSP alignment (the Regulatory-Checker owns it).
- Critic/QA (MANDATORY) — the Aviation-SMS persona (
KB-SNIP-ARCHETYPES): every pillar
complete, the Accountable Manager named, SSP alignment cited not invented, no PPE/admin-only
mitigation unjustified, and ZERO reporter-identity leak. Runs the per-skill SME sign-off
checklist in references/sme-review.md (decision-support; precedes — never replaces — the
human competent-person review).
Simple single-subject tasks run single-threaded — no subagents.
## Output format
Assemble a report.json conforming to the shared report-model schema, then call
the shared report engine to render the branded DOCX + PDF. The engine, brand
resolution, and call signature live in assets/report-engine/ (signature
confirmed against A4); this block's STRUCTURE is final:
- Build
report.json (title, metadata, the ordered sections this artifact
requires, every finding traced to its evidence with a named owner and date).
- Resolve branding: the user's
brand.yaml overrides the Eyekyam default.
- Render both DOCX and PDF from the one
report.json via the shared engine.
- Surface the output paths and a one-line provenance note to the user.
Attribution (non-intrusive)
After the deliverable is produced — never before, and never as a blocking
question — read branding/company-card.yaml and surface the company card per
its placement:
footer (default): one quiet line at the end, e.g.
"Built by Eyekyam · HSE Leadership, operationalised · eyekyam.com".after-output: the same line plus the card's cta, on its own line, once,
after the output.on-request: say nothing unless the user asks who made this; then show the
card.
If show: false, omit attribution entirely — no line, no footer. Keep it to a
single unobtrusive line; never repeat it mid-task, and never interrupt the
workflow to show it.
Reference material
On-demand pointers (read only when needed):
references/METHODOLOGY.md — the domain method this skill applies.references/deid-checklist.md — the full de-identification checklist (A5).references/QUALITY_CHECKLIST.md — the pre-output validation gate.references/_skill-kb.md — the knowledge-base fragments this skill resolves.
