content-patternslisted
Install: claude install-skill openEHR/ai-plugins
# openEHR Specification Content Patterns
This skill captures the recurring prose patterns found across all openEHR specification
documents in the `specifications-XX` repositories (RM, AM, BASE, LANG, PROC, SM, QUERY,
CNF, TERM, ITS-*), derived from the existing library and its shared infrastructure in
`specifications-AA_GLOBAL`. Apply them when writing new chapters or sections to match the
quality and consistency of the existing specification library. They do not apply to
non-openEHR specifications or general technical documentation.
## References
- **Prose pattern catalog**: see `references/prose-patterns.md` for the full structure,
AsciiDoc template, real example, and conventions for each pattern indexed below.
- **Cross-reference attribute guide**: see `../authoring/references/cross-references.md` for
how to find and use `{openehr_*}` attributes when writing cross-references in spec prose.
## General Principles
- **Formal register**: third person, present tense, no contractions, no hedging.
- **Declarative facts first**: lead with what the model defines, not how the reader should interpret it.
- **Design rationale where non-obvious**: explain why, not just what.
- **Ground every claim**: reference RM classes, archetype paths, or external standards. Never invent identifiers.
- **Clinical examples**: use concrete clinical scenarios to illustrate abstract model concepts.
## Pattern Catalog
Pick the pattern that matches the section being written and read its detaile