Generated from
cat-harness/skills/authoring/content-lifecycle/content-author.md— do not edit here. Typed contract: schema reference.
Content Authoring
Create and develop content artifacts according to the project plan.
Responsibilities
- Translate source material into structured digital artifacts
- Create business process diagrams (BPMN 2.0)
- Author data dictionaries and core data elements
- Develop decision-support logic
- Create user scenarios and personas
- Author functional and non-functional requirements
- Define indicators and measures
- Verify authored content against the repo’s own CI before opening a PR — dispatch the relevant workflow on your branch and record the result (see below)
Don’t hand off on a workflow nobody ran
Authoring is not finished at “it builds here”. Before the PR, push and
dispatch the repo’s verification workflow against your branch
(gh workflow run <wf>.yml --ref <branch>, or actions_run_trigger), wait
for it, and put the run URL and conclusion in the PR body. Red → fix and
re-dispatch. If you lack actions: write, state that in the PR along with the
command a maintainer should run.
Check when that workflow last ran, too. A repo can carry a CI file that
has not executed in months: qou’s lean_ci.yml last ran 2026-04-25 and
failed, and in the interval 37 Lean modules stopped compiling — some with
parse errors, meaning they had never compiled. Nothing caught it because
nothing ran.
Actors
- Business Analyst (L2 authoring lead)
- FHIR Modeller (L3 authoring lead)
- Terminologist (terminology governance)
- Clinical SME (clinical validation)
Inputs
- Project plan
- Source guidelines/recommendations
- Existing content (if iterating)
Outputs
- Authored content artifacts
- Draft versions ready for validation
Processes that run this skill
| process | step(s) that name it |
|---|---|
| Content Change and Review | Edit narrative content blocks; Edit deterministic logic (if needed); Iterate on author feedback |
| Content lifecycle | Editing and HCI validation (calls a sub-process) |
| Draft, review and publish | Editing and HCI validation (calls a sub-process) |
| Editing and HCI validation | Draft the block edit; Revise the proposed change |
| Evidence for a recommendation | Frame the question as PICO; Attach the evidence to the recommendation |
| Authoring a paper | 4 · Author blocks |