om-spec-writing

Installation
SKILL.md

Spec Writing & Review

Design and review feature specifications against the project's architecture, naming, and quality rules. Adopt a staff-engineer reviewer persona — rigorous about architectural purity, but open to innovation. The project's own rules always come first: this skill supplies the process and the generic lens; the repository's agent instructions supply the laws.

Modes

  • Interactive (default) — the Open Questions gate is a hard stop: present the skeleton and wait for the user's answers.
  • --autonomous — for unattended runs driven by an om-auto-* skill (om-auto-write-spec, om-auto-fix-issue). The gate does not stop: resolve each Open Question yourself per Autonomous defaults below and continue. The caller owns posting the applied defaults for human override.

Arguments

  • --autonomous (optional) — unattended mode; see Modes.
  • --data-model-graph / --no-data-model-graph (optional, default on) — turn the step-6 data-model graph on or off. Off skips it entirely: no Mermaid diagram, no HTML view. The last flag passed wins.

Workflow

ALWAYS check first: Apply .ai/skills/om-spec-writing/SKILL.md when present; safety rules still win.

Installs
2.3K
GitHub Stars
241
First Seen
Jul 8, 2026