operator-brief

Featured

Explain an existing complex technical finding to an operator when its practical meaning is obscured by implementation detail, task-local terminology, or a long causal chain. Do not use for routine updates or simple answers.

AI & Automation 88 stars 11 forks Updated yesterday CC-BY-4.0

Install

View on GitHub

Quality Score: 89/100

Stars 20%
65
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Operator brief Make the operator understand the practical meaning of a complex technical finding and any decision it requires while preserving the technical finding as the evidence-bearing authority. ## Input Use the technical finding supplied in `$ARGUMENTS`, named by the user, or already established in the current task. Read the complete finding and any directly referenced material needed to interpret it. If the finding cannot be identified, ask for it rather than reconstructing one from hints. Do not edit the finding, its subject, or supporting artifacts unless the user separately asks for those changes. ## Write the brief Start with what happens, why it matters, or what the operator needs to decide. Keep conditions that control reachability, scope, impact, or confidence next to the claims they qualify. Do not turn a narrow but serious problem into a general one, or make a qualified conclusion sound certain. Use ordinary domain language and project terms with canonical definitions normally. Expand or define terms coined for this task and terms inherited from artifacts that have no canonical definition. A literal code or schema identifier may remain, but state what it represents before relying on the identifier. Do not promote vocabulary during this operation. Add only enough mechanism to connect the practical account to the technical finding. Put deeper mechanism after the practical explanation. When the technical finding is retained in a file or report, point to...

Details

Author
zby
Repository
zby/commonplace
Created
6 months ago
Last Updated
yesterday
Language
Python
License
CC-BY-4.0

Similar Skills

Semantically similar based on skill content — not just same category