Lintel on GitHub Copilot. Generated from skills/generate-visio/SKILL.md; edit the canonical file, then run
li-copilot init.
- Resource root:
../../.. from this skill's base directory (the Lintel source with bin/,
lib/, skills/). Write plans, state and evidence into the working repository's .claude/
tree, never into the resource root.
- Skill-relative paths: this skill's own
scripts/, references/ and data/ folders (and a
<base> that the workflow defines as its own directory) mean
../../../skills/generate-visio/ in the Lintel source, not this generated folder.
${LINTEL_SKILLS_DIR:-skills} means the skills root, ../../../skills. A bin/li-run step
runs in the working repository, so use $LINTEL_SKILLS_DIR/generate-visio/ there.
- Shell steps: run Bash snippets with Bash (Git for Windows'
bash.exe on Windows, never
System32\bash.exe). Save a snippet to a temporary .sh file and run
bash "<resource root>/bin/li-run" <file>; it prepares LINTEL_SOURCE_ROOT, LINTEL_REPO_ROOT
and the profile context.
- Tools: Read=
view, Write=create, Edit=edit, Bash=bash/powershell, Grep=grep,
Glob=glob, AskUserQuestion=ask_user, TodoWrite=the plan checklist, Task or a named role=task
with that custom agent, WebFetch=web_fetch.
- Other Lintel workflows are native skills: invoke
/li-<name> rather than reading their
files. Named roles such as CodeReviewer are custom agents.
Visio format preflight
Lintel has no bundled writer for this entrypoint. The public name and source
mapping remain a staged template slot, not an implemented VSDX generator.
This preflight establishes what the operator actually requested and what an
available authorized writer can produce and inspect; it does not invent a
workflow, renderer or tool. A frontmatter full hint is not live availability.
The retained --output-format <vsdx|svg|png|drawio> spelling expresses the
actual requested format, not a promise that all four can be written. Accept
--from-pipeline <run-dir> or a directly supplied brief. No output format is
silently substituted when the requested writer is absent.
Preflight before an output write
- Confirm the requested result. Read the explicit brief and, for a selected
pipeline run, its current
content.md, outline/notes_for_writer and
design-spec.json where applicable. Keep source facts, topology, qualifications,
captions and evidence pointers. Architecture sketches, network layouts,
deployment pipelines, swimlanes, cross-functional flowcharts and sequence
diagrams remain supported planning subjects, not proof of file-generation
capability. Confirm whether the requested result is editable VSDX/drawio or an
explicitly requested SVG or PNG export. Ambiguous format/content or a missing
required run/design input returns NEEDS_CONTEXT, not an invented architecture.
- Keep source/profile authority. Retain the selected work, current P07
reference and applicable controls. Use the shared
source-fidelity method.
GENERATE's input helper currently admits Word/PPT/PDF/XLSX, not Visio; reading
pipeline files here does not claim that helper accepted a Visio input or that
the run's other formats passed. No new admission schema or renderer is supplied.
- Identify the real writer and inspection operations. Inspect the current
host's actual tools, supported formats and operation permissions. Name the
available authorized writer for the exact requested format, plus its save,
reopen/edit, connector/label readback and required inspection operations.
Neither an agent, a catalog selection, a library name nor an installed app
alone supplies these operations. Missing writer/editor operations keep the
requested artifact blocked. This missing capability blocks only that output;
preserve independent supported outputs and report their separate status.
- Select authorized inputs and output. Use only explicitly supplied or
verified-profile template/stencil sources with actual access and applicable
brand/provenance permission. This method does not install libraries, search
personal template homes or assume a template exists. A neutral shape/stencil
choice needs an explicit applicable choice, not a required-brand bypass.
Confirm an owned output path and preserve supplied artifacts; no implicit
overwrite, personal-home or current-directory fallback.
- Declare proof before production. Record the required format, source
retention, editable reopen, connectors, labels and required inspection
observations under the existing evidence/profile contract. Required missing,
failed or unverified observations block completion. Plan the appropriate
diagram type, layout and connector directions from the supplied source.
Use the selected design palette and applicable provider stencils when present;
do not infer live cloud topology or choose a provider from a generic example.
Conditional production and actual proof
Proceed only through the writer established above and within its granted scope.
This section is an evidence obligation for an externally supplied capability,
not a bundled implementation.
- Record the actual writer operation, output path and result. Verify the saved
artifact's actual requested format; a file extension is not format evidence.
No image-as-VSDX substitution: an embedded raster, renamed SVG/PNG, preview
or screenshot cannot satisfy an editable VSDX/drawio request. Switching formats
requires an explicit changed request, never an implicit fallback.
- For editable output, reopen the saved artifact using the available authorized
editor. Observe native shapes, connectors with their actual endpoint bindings
and directions, and editable labels. Exercise a bounded edit on an owned copy,
save and reopen it, then read back the changed label/connection. Preserve the
original supplied sources and identify which final artifact was inspected.
An opaque imported image or a package that merely opens is insufficient.
- Compare every source entity, connection, label/caption and qualification with
the saved result. Inspect stencil consistency and visible layout at the actual
permitted rendering layer, recording missing, clipped or disconnected content.
SVG/PNG exports need actual format/content and required visual observations;
they do not establish editable-diagram proof or VSDX support.
- Invoke
/li-generate-qa --artifacts <diagram-path> only on an actually produced
selected artifact, retaining report-only QA and its source comparison. Repair
requires a distinct authorized output and renewed affected evidence.
QA handoff is not completion evidence. Consume actual QA/inspection results
for the same artifact, source and profile. Missing rendering, readback or required
independent review stays unverified; an empty issues list cannot clear it.
- Return requested versus produced format, source/artifact identities, actual
operations and observations, gates, unavailable capabilities and the next
supported action. A preview can be reported as a preview, never as a completed
requested editable deliverable.
Optional architecture advice
Per skills/generate/agent-mapping.yaml, these retained names are source hints,
not automatic dispatch:
- Primary: SystemArchitect — architecture/topology advice when requested.
- Conditional: SecurityAuditor — advice on trust zones/DMZ when requested and authorized.
Use only the roles actually declared by that mapping and available on the host.
SystemArchitect can advise on topology; neither role is a Visio writer or proof
that a requested output format can be produced. No new actor is required to
report an unavailable writer, and advisory work does not satisfy independent review.
Voice and sharing
voice: internal is the default. Labels and captions retain the applicable
voice/source-fidelity obligations. With --customer-share, preserve the actual
upstream voice-gate result on unchanged labels where the active pack requires it
(voice.gates_active; none by default), plus all applicable brand, compliance,
honest-limitations and provenance requirements. A mandatory unverified gate
blocks that output. A produced diagram or successful QA is not distribution
permission; this preflight sends nothing.
Reusable patterns
Follow the reusable pattern consumer contract.
Resolve or verify the supplied attachment and record each mandatory pattern clause
as unverified unless its presence in the produced diagram was actually inspected.
Patterns never promote this staged template slot, and diagrams are not verified
cloud state.
Status protocol
- DONE — only the actual requested format was produced by an available
authorized writer, its required source/format, connector/label, QA and required
inspection evidence (including editable reopen for editable outputs) were
observed for the same artifact, and
every applicable mandatory control and pattern clause passed. This does not
claim Lintel implements a VSDX writer.
- DONE_WITH_CONCERNS — the same required proof as DONE, with only explicitly
advisory limitations; never a missing writer, required inspection or failed
mandatory clause.
- BLOCKED — a requested writer/operation, authority or required proof is
missing, failed or unverified. Keep other independent requested outputs separate.
- NEEDS_CONTEXT — the requested format, diagram source, selected run/design,
output ownership or required template choice is unresolved.
Next supported action
Report the missing operation and preserve any source preparation. The operator
may explicitly select a real authorized writer or change the requested output;
neither is assumed. Feed an actually approved export into the selected deck or
document method only through its supported input contract. For several requested
formats, GENERATE retains the separate per-format gates and unfinished-output
report. Repeated requests or a useful layout do not automatically promote the
slot, install dependencies or waive format acceptance.
1---2name: li-generate-visio3description: Use when a request calls for architecture, network or process-flow diagrams through the Visio scaffolding slot; no curated generation workflow is supplied.4metadata:5 source: https://skillmd.com/skills/jokerman89/li-generate-visio6---78> **Lintel on GitHub Copilot.** Generated from `skills/generate-visio/SKILL.md`; edit the canonical file, then run9> `li-copilot init`.10> - **Resource root:** `../../..` from this skill's base directory (the Lintel source with `bin/`,11> `lib/`, `skills/`). Write plans, state and evidence into the working repository's `.claude/`12> tree, never into the resource root.13> - **Skill-relative paths:** this skill's own `scripts/`, `references/` and `data/` folders (and a14> `<base>` that the workflow defines as its own directory) mean15> `../../../skills/generate-visio/` in the Lintel source, not this generated folder.16> `${LINTEL_SKILLS_DIR:-skills}` means the skills root, `../../../skills`. A `bin/li-run` step17> runs in the working repository, so use `$LINTEL_SKILLS_DIR/generate-visio/` there.18> - **Shell steps:** run Bash snippets with Bash (Git for Windows' `bash.exe` on Windows, never19> `System32\bash.exe`). Save a snippet to a temporary `.sh` file and run20> `bash "<resource root>/bin/li-run" <file>`; it prepares `LINTEL_SOURCE_ROOT`, `LINTEL_REPO_ROOT`21> and the profile context.22> - **Tools:** Read=`view`, Write=`create`, Edit=`edit`, Bash=`bash`/`powershell`, Grep=`grep`,23> Glob=`glob`, AskUserQuestion=`ask_user`, TodoWrite=the plan checklist, Task or a named role=`task`24> with that custom agent, WebFetch=`web_fetch`.25> - **Other Lintel workflows** are native skills: invoke `/li-<name>` rather than reading their26> files. Named roles such as `CodeReviewer` are custom agents.2728## Visio format preflight2930Lintel has no bundled writer for this entrypoint. The public name and source31mapping remain a staged template slot, not an implemented VSDX generator.32This preflight establishes what the operator actually requested and what an33available authorized writer can produce and inspect; it does not invent a34workflow, renderer or tool. A frontmatter `full` hint is not live availability.3536The retained `--output-format <vsdx|svg|png|drawio>` spelling expresses the37actual requested format, not a promise that all four can be written. Accept38`--from-pipeline <run-dir>` or a directly supplied brief. No output format is39silently substituted when the requested writer is absent.4041## Preflight before an output write42431. **Confirm the requested result.** Read the explicit brief and, for a selected44 pipeline run, its current `content.md`, outline/`notes_for_writer` and45 `design-spec.json` where applicable. Keep source facts, topology, qualifications,46 captions and evidence pointers. Architecture sketches, network layouts,47 deployment pipelines, swimlanes, cross-functional flowcharts and sequence48 diagrams remain supported planning subjects, not proof of file-generation49 capability. Confirm whether the requested result is editable VSDX/drawio or an50 explicitly requested SVG or PNG export. Ambiguous format/content or a missing51 required run/design input returns NEEDS_CONTEXT, not an invented architecture.522. **Keep source/profile authority.** Retain the selected work, current P0753 reference and applicable controls. Use the shared54 [source-fidelity method](../../../skills/generate-write/references/fidelity-and-evidence.md).55 GENERATE's input helper currently admits Word/PPT/PDF/XLSX, not Visio; reading56 pipeline files here does not claim that helper accepted a Visio input or that57 the run's other formats passed. No new admission schema or renderer is supplied.583. **Identify the real writer and inspection operations.** Inspect the current59 host's actual tools, supported formats and operation permissions. Name the60 available authorized writer for the exact requested format, plus its save,61 reopen/edit, connector/label readback and required inspection operations.62 Neither an agent, a catalog selection, a library name nor an installed app63 alone supplies these operations. Missing writer/editor operations keep the64 requested artifact blocked. This missing capability blocks only that output;65 preserve independent supported outputs and report their separate status.664. **Select authorized inputs and output.** Use only explicitly supplied or67 verified-profile template/stencil sources with actual access and applicable68 brand/provenance permission. This method does not install libraries, search69 personal template homes or assume a template exists. A neutral shape/stencil70 choice needs an explicit applicable choice, not a required-brand bypass.71 Confirm an owned output path and preserve supplied artifacts; no implicit72 overwrite, personal-home or current-directory fallback.735. **Declare proof before production.** Record the required format, source74 retention, editable reopen, connectors, labels and required inspection75 observations under the existing evidence/profile contract. Required missing,76 failed or unverified observations block completion. Plan the appropriate77 diagram type, layout and connector directions from the supplied source.78 Use the selected design palette and applicable provider stencils when present;79 do not infer live cloud topology or choose a provider from a generic example.8081## Conditional production and actual proof8283Proceed only through the writer established above and within its granted scope.84This section is an evidence obligation for an externally supplied capability,85not a bundled implementation.8687- Record the actual writer operation, output path and result. Verify the saved88 artifact's actual requested format; a file extension is not format evidence.89 **No image-as-VSDX substitution:** an embedded raster, renamed SVG/PNG, preview90 or screenshot cannot satisfy an editable VSDX/drawio request. Switching formats91 requires an explicit changed request, never an implicit fallback.92- For editable output, reopen the saved artifact using the available authorized93 editor. Observe native shapes, connectors with their actual endpoint bindings94 and directions, and editable labels. Exercise a bounded edit on an owned copy,95 save and reopen it, then read back the changed label/connection. Preserve the96 original supplied sources and identify which final artifact was inspected.97 An opaque imported image or a package that merely opens is insufficient.98- Compare every source entity, connection, label/caption and qualification with99 the saved result. Inspect stencil consistency and visible layout at the actual100 permitted rendering layer, recording missing, clipped or disconnected content.101 SVG/PNG exports need actual format/content and required visual observations;102 they do not establish editable-diagram proof or VSDX support.103- Invoke `/li-generate-qa --artifacts <diagram-path>` only on an actually produced104 selected artifact, retaining report-only QA and its source comparison. Repair105 requires a distinct authorized output and renewed affected evidence.106 **QA handoff is not completion evidence.** Consume actual QA/inspection results107 for the same artifact, source and profile. Missing rendering, readback or required108 independent review stays unverified; an empty issues list cannot clear it.109- Return requested versus produced format, source/artifact identities, actual110 operations and observations, gates, unavailable capabilities and the next111 supported action. A preview can be reported as a preview, never as a completed112 requested editable deliverable.113114## Optional architecture advice115116Per `skills/generate/agent-mapping.yaml`, these retained names are source hints,117not automatic dispatch:118- Primary: SystemArchitect — architecture/topology advice when requested.119- Conditional: SecurityAuditor — advice on trust zones/DMZ when requested and authorized.120121Use only the roles actually declared by that mapping and available on the host.122SystemArchitect can advise on topology; neither role is a Visio writer or proof123that a requested output format can be produced. No new actor is required to124report an unavailable writer, and advisory work does not satisfy independent review.125126## Voice and sharing127128`voice: internal` is the default. Labels and captions retain the applicable129voice/source-fidelity obligations. With `--customer-share`, preserve the actual130upstream voice-gate result on unchanged labels where the active pack requires it131(`voice.gates_active`; none by default), plus all applicable brand, compliance,132honest-limitations and provenance requirements. A mandatory unverified gate133blocks that output. A produced diagram or successful QA is not distribution134permission; this preflight sends nothing.135136## Reusable patterns137138Follow the [reusable pattern consumer contract](../../../skills/pattern/references/consumer-contract.md).139Resolve or verify the supplied attachment and record each mandatory pattern clause140as unverified unless its presence in the produced diagram was actually inspected.141Patterns never promote this staged template slot, and diagrams are not verified142cloud state.143144## Status protocol145146- **DONE** — only the actual requested format was produced by an available147 authorized writer, its required source/format, connector/label, QA and required148 inspection evidence (including editable reopen for editable outputs) were149 observed for the same artifact, and150 every applicable mandatory control and pattern clause passed. This does not151 claim Lintel implements a VSDX writer.152- **DONE_WITH_CONCERNS** — the same required proof as DONE, with only explicitly153 advisory limitations; never a missing writer, required inspection or failed154 mandatory clause.155- **BLOCKED** — a requested writer/operation, authority or required proof is156 missing, failed or unverified. Keep other independent requested outputs separate.157- **NEEDS_CONTEXT** — the requested format, diagram source, selected run/design,158 output ownership or required template choice is unresolved.159160## Next supported action161162Report the missing operation and preserve any source preparation. The operator163may explicitly select a real authorized writer or change the requested output;164neither is assumed. Feed an actually approved export into the selected deck or165document method only through its supported input contract. For several requested166formats, GENERATE retains the separate per-format gates and unfinished-output167report. Repeated requests or a useful layout do not automatically promote the168slot, install dependencies or waive format acceptance.