Off nominal review
Skill e3742526/agent-skills-for-quality/skills/off-nominal-review
Various agent skills I wrote (co-wrote?) to make my apps more dependable
npx -y skills add e3742526/agent-skills-for-quality --skill off-nominal-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Review software and operational workflows using NASA-style nominal versus off-nominal scenario analysis. Use when auditing safeguards, fault management, containment, degraded behavior, and operator-visible handling of unexpected conditions.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.7 KB, 918 tokens by cl100k_base, as published. Nobody here has run it
Off-Nominal Review
Mission
Review a system the way a mission or operations team would: not only for the happy path, but for off-nominal conditions, unexpected environment changes, unsafe transitions, missing safeguards, and weak containment boundaries.
This is a public, software-oriented adaptation of NASA systems thinking. It is not a formal hazard analysis or safety certification method.
Source basis
This skill is shaped by the NASA Systems Engineering Handbook, Rev 2 (NASA/SP-2016-6105 Rev2). Read references/nasa-principles.md before using the skill for a deeper review.
When to use
Use this skill when the system has material workflows, lifecycle transitions, or operator-facing recovery decisions, including:
- daemons and workers
- controllers and state machines
- import, export, or migration tools
- orchestration and deployment workflows
- pipelines with partial outputs or retries
- systems that claim degraded operation or fault tolerance
Review posture
Model the target as a set of operational scenarios. For each material workflow:
- Define the nominal path.
- Enumerate off-nominal conditions.
- Identify the safeguard, containment, or operator signal that should exist.
- Trace whether that mechanism is actually implemented.
- Record both findings and non-findings.
Off-nominal scenario inventory
Check at least these conditions where relevant:
- required dependency absent
- configuration inconsistent with environment
- operator chooses the wrong target or mode
- timeout, empty response, or malformed response
- delayed but not failed dependency
- partial write or interrupted state transition
- duplicate message, job, or rerun
- stale cache, checkpoint, or lock
- cleanup path not reached
- degraded mode entered without clear signal
Scenario worksheet
Build a worksheet before findings:
| Workflow | Nominal goal | Off-nominal trigger | Required safeguard | Current handling | Residual risk |
|---|---|---|---|---|---|
| batch import | import one file once | duplicate rerun | idempotent checkpoint | file may replay | duplicate records |
The required safeguard can be technical, procedural, or operator-visible, but it must be explicit.
Review angles
Inspect each workflow from these angles:
- transition into work
- transition out of work
- partial progress boundary
- operator decision point
- dependency instability
- containment of bad state
- recoverability after interruption
- visibility to the next operator
Guard questions
Ask questions like:
- What is the first irreversible side effect?
- What must be true before that point?
- What happens if that assumption fails one step later instead?
- What evidence would tell the operator the workflow is now off-nominal?
- Can the system contain the problem locally, or does it leak ambiguity downstream?
- What state must be preserved, rolled back, quarantined, or recomputed?
Expected safeguard vocabulary
Use concrete safeguard terms when appropriate:
- interlock
- preflight
- hold point
- explicit degrade
- quarantine
- containment boundary
- rollback point
- operator acknowledgment
- restart barrier
Finding format
Use this format:
ONR-XXX: Short title
- Severity: Low / Medium / High / Critical
- Workflow: affected workflow or transition
- Off-nominal trigger: unexpected condition
- Required safeguard: the control or signal that should exist
- Current handling: what exists today
- Evidence: code path, config path, procedure, or observed behavior
- Impact: operational or integrity consequence
- Recommended change: the narrowest change that restores the safeguard
- Tests: scenario or regression test that should prove the safeguard
Non-findings
Record explicit non-findings when the system appears to:
- reject unsafe entry conditions
- contain bad state before propagation
- surface degraded mode honestly
- preserve clear ownership of operator decisions
- avoid ambiguous partial completion
Output contract
Produce:
- a short posture summary
- the scenario worksheet
- findings
- explicit non-findings
- a prioritized safeguard backlog
- tests or drills that would strengthen confidence
- limits of analysis
Limits
- Do not present this as formal FMEA, STPA, or certification evidence.
- Do not overclaim runtime behavior without concrete evidence.
- Keep the review anchored to implemented safeguards, not abstract safety language.
What ships with it: 2 files
1.7 KB alongside SKILL.md
agents/
- openai.yaml303 B
references/
- nasa-principles.md1.4 KB