Skip to content
 
 

Repository files navigation

Editorial

Healthcare-grounded editorial standards for product writing — voice, tone, language, microcopy patterns, and safety-critical copy.

Treat the reader's time as more valuable than your own.

What's in this repo

  • editorial-policy.md — voice, tone, language rules, healthcare content standards, audience adaptation.
  • ui-writing-spec.md — how text behaves inside interface components: buttons, errors, banners, forms, multi-step flows, dates, numbers, bulk operations, loading states, message severity, data freshness.
  • working-with-ai.md — how writers and AI tools should apply both documents.
  • skills/cthesigns-editorial.md — Claude Code skill that loads the docs and applies the rules.

Who this is for

UX writers, product designers, clinicians who write copy, and engineers who write UI strings — particularly in healthcare or clinical contexts.

The principles are universal; the examples are healthcare-grounded. Adapt the cancer, risk, and clinical workflow guidance to your own domain if you fork.

Who this is not for

  • Marketing copy, brand voice work, or long-form content writing — the rules are tuned for product interfaces.
  • Teams looking for a fork-and-replace template. This is opinionated. For a generic content design framework, see GOV.UK Content Design or the 18F Content Guide.

Using the Claude Code skill

Copy skills/cthesigns-editorial.md to your .claude/skills/ directory. Claude Code will load the skill automatically.

When the skill is active, ask Claude to draft, review, or refine UX copy and it will read the docs and apply the rules.

Versioning

Releases use CalVer (YYYY.MM.PATCH). The current release is tagged in the Releases tab. Pin to a specific tag for stable references in your own work — the docs evolve.

Attribution

Originally drafted by the C the Signs design team. C the Signs is an AI-powered clinical decision support platform for early cancer detection, built across the NHS and US healthcare markets.

Licence

CC BY 4.0. Use freely, adapt, redistribute. Attribution required.

A note on healthcare guidance

This repo includes guidance on cancer language, algorithm output, and clinical safety copy. Apply that guidance to your own product only with qualified clinical review. CC BY 4.0 carries no warranty; nothing here is medical or regulatory advice.

About

C the Signs editorial policy, UI writing spec, and AI working guidelines (personal mirror)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors