← ClaudeAtlas

content-patternslisted

Patterns for writing production-quality openEHR specification prose — overviews, class/concept semantics, design rationale, and clinical examples — in `specifications-XX` repos. This skill should be used when the user asks how to phrase or improve spec prose, draft a package/class description, write a design-rationale or semantics section, or asks about openEHR spec writing style. Not for creating or scaffolding the document or its structure (use authoring), amendment records (use amendment-record), or non-openEHR writing.
openEHR/ai-plugins · ★ 2 · AI & Automation · score 73
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