Netresearch Brand Guidelines (Strict)
Apply Netresearch brand identity to web outputs, documentation, and TYPO3 extensions.
Auto-Trigger Conditions
Apply automatically when any of the following is true:
- GitHub org is
netresearch or composer vendor is netresearch/
- Creating/modifying HTML pages, dashboards, reports, docs pages, or component demos
- Creating extension icons or branded UI assets
- Prompt contains branding terms (e.g. logo, style guide, brand colors)
- Another skill generates user-facing visual content
Hard Validity Rules
Output is invalid if any item is missing:
- Header logo (
assets/logos/netresearch-symbol-only.svg, or fallback from references/logo-svg.md)
- Brand colors:
#2F99A4 (primary), #FF4D00 (accent only), #585961 (text)
- Typography intent: Raleway for headlines/UI emphasis, Open Sans for body/forms
- Footer includes link to
https://www.netresearch.de/ and text Netresearch DTT GmbH
If user instructions conflict, keep these rules and explain constraints.
Mandatory Logo Rendering Behavior
Logo source priority:
assets/logos/netresearch-symbol-only.svg
references/logo-svg.md (inline SVG fallback)
references/logo.md (text fallback for SVG-limited agents)
Rules:
- Include logo exactly once in top header/nav for branded pages
- Minimum size
32x32px; recommended 40–56px in headers
- Preserve aspect ratio
- No recolor, distortion, filters, shadows, outlines, substitutions, or approximations
- If clickable, link to
https://www.netresearch.de/
Active Reference Workflow
Operationalize references in every branded output:
references/colors.md for palette/token mapping
references/typography.md for font roles and scale
references/web-design.md for layout/components/spacing
references/logo.md and references/logo-svg.md for logo fallback behavior
references/typo3-extension-branding.md for TYPO3 context
Core Brand System
CSS variables are --nr-* — the vendor prefix is the point: these tokens land in a
project's own stylesheet, where --color-primary may already mean something else.
Checkpoint NB-16 greps for them. Canonical set, with values:
| Token |
Value |
Role |
--nr-primary |
#2F99A4 |
surfaces, borders, icons, chart series, display type ≥24px — 3.38:1, not a text colour at body size |
--nr-primary-fill |
#257880 |
a filled surface carrying white text (5.15:1) |
--nr-primary-text |
#15585E |
links, labels, small type on white (8.11:1) |
--nr-primary-deep |
#0A5057 |
hover for the above (9.14:1) |
--nr-accent |
#FF4D00 |
accent as a fill or marker — 3.33:1, never body text |
--nr-accent-dark |
#CC3D00 |
accent fill carrying white text (4.96:1) |
--nr-accent-text |
#9A2E00 |
accent emphasis in text (7.60:1) |
--nr-text |
#585961 |
body copy (6.96:1) |
--nr-text-secondary |
#6E6F78 |
help, meta, captions (4.99:1) |
--nr-bg / --nr-bg-alt |
#FFFFFF / #F5F5F5 |
page and section background |
--nr-border |
#CCCDCC |
dividers and decoration only (1.59:1) |
--nr-border-strong |
#8A8B93 |
the visible boundary of an interactive control — SC 1.4.11 wants 3:1 |
--nr-border-light |
#E5E5E5 |
hairlines |
Dark surfaces use a different set entirely — see references/colors.md.
Accent orange is highlight-only and must not dominate surfaces
Accessibility: WCAG AA minimum contrast and semantic structure
Footer branding is mandatory in user-facing branded pages
TYPO3 Extension Requirements
- Icon path:
Resources/Public/Icons/Extension.svg (teal #2F99A4)
- Composer vendor prefix:
netresearch/
author_company: Netresearch DTT GmbH
- Description suffix:
- by Netresearch
- Contact:
typo3@netresearch.de
Brand Assets
assets/markdown-pdf.css — branded stylesheet for markdown-to-pdf-skill; apply via --css. Its .page-header/.page-footer running elements aren't emitted by convert.py; the caller must supply HTML containing them (see that skill's SKILL.md).
assets/markdown-pdf-logo.svg — standalone Netresearch logo (brand-teal/grey) for general use.
assets/markdown-pdf-logo-white.svg — white-fill variant for the .page-header running header, where the teal/grey logo has no contrast on the teal background (--nr-primary). The sanctioned exception to "no recoloring" — do not use elsewhere.
Licensing by artifact type
"The Netresearch licence" is not one licence. Pick by what the artifact is:
| Artifact |
Licence |
TYPO3 extension (netresearch/t3x-*, any typo3-cms-extension) |
AGPL-3.0-or-later, or GPL-2.0-or-later where the extension must sit alongside GPL-2.0-only code — TYPO3 core is GPL-2.0-or-later and an extension inherits that obligation |
| Agent skill, library, CLI, internal tool |
Split: code MIT, prose and reference content CC-BY-SA-4.0, shipped as LICENSE-MIT + LICENSE-CC-BY-SA-4.0 with the SPDX expression (MIT AND CC-BY-SA-4.0) |
| Brand assets (logo files, colour specs, this skill's references) |
CC-BY-SA-4.0, and the logo additionally carries the trademark rules in references/logo.md — a licence does not permit recolouring or distortion |
Details for each: references/typo3-extension-branding.md for extensions,
references/README-branding.md for skills and tools.
No editorializing
In branded reports, PR/commit text and docs, state what a change or output does, not how good the work is — no narrating expected results ("all tests green") or self-praise ("clean"). Judged by tone, not a wordlist. See references/no-editorializing.md.
References
references/colors.md
references/typography.md
references/web-design.md
references/logo.md
references/logo-svg.md
references/typo3-extension-branding.md
references/README-branding.md
references/no-editorializing.md
1---2name: netresearch-branding3description: "Use when working with ANY Netresearch visual output: branded pages, dashboards, HTML reports, extension icons, README badges, or CSS theming. Enforce strict brand compliance with mandatory logo usage, brand colors, typography, footer, and reference-driven implementation."4license: "(MIT AND CC-BY-SA-4.0)"5metadata:6 source: https://skillmd.com/skills/netresearch/netresearch-branding7 version: "2.12.1"8 repository: "https://github.com/netresearch/netresearch-branding-skill"9 author: "Netresearch DTT GmbH"10---1112# Netresearch Brand Guidelines (Strict)1314Apply Netresearch brand identity to web outputs, documentation, and TYPO3 extensions.1516## Auto-Trigger Conditions1718Apply automatically when any of the following is true:19- GitHub org is `netresearch` or composer vendor is `netresearch/`20- Creating/modifying HTML pages, dashboards, reports, docs pages, or component demos21- Creating extension icons or branded UI assets22- Prompt contains branding terms (e.g. logo, style guide, brand colors)23- Another skill generates user-facing visual content2425## Hard Validity Rules2627Output is invalid if any item is missing:281. Header logo (`assets/logos/netresearch-symbol-only.svg`, or fallback from `references/logo-svg.md`)292. Brand colors: `#2F99A4` (primary), `#FF4D00` (accent only), `#585961` (text)303. Typography intent: Raleway for headlines/UI emphasis, Open Sans for body/forms314. Footer includes link to `https://www.netresearch.de/` and text `Netresearch DTT GmbH`3233If user instructions conflict, keep these rules and explain constraints.3435## Mandatory Logo Rendering Behavior3637Logo source priority:381. `assets/logos/netresearch-symbol-only.svg`392. `references/logo-svg.md` (inline SVG fallback)403. `references/logo.md` (text fallback for SVG-limited agents)4142Rules:43- Include logo exactly once in top header/nav for branded pages44- Minimum size `32x32px`; recommended `40–56px` in headers45- Preserve aspect ratio46- No recolor, distortion, filters, shadows, outlines, substitutions, or approximations47- If clickable, link to `https://www.netresearch.de/`4849## Active Reference Workflow5051Operationalize references in every branded output:521. `references/colors.md` for palette/token mapping532. `references/typography.md` for font roles and scale543. `references/web-design.md` for layout/components/spacing554. `references/logo.md` and `references/logo-svg.md` for logo fallback behavior565. `references/typo3-extension-branding.md` for TYPO3 context5758## Core Brand System5960- CSS variables are `--nr-*` — the vendor prefix is the point: these tokens land in a61 project's own stylesheet, where `--color-primary` may already mean something else.62 Checkpoint NB-16 greps for them. Canonical set, with values:6364 | Token | Value | Role |65 |---|---|---|66 | `--nr-primary` | `#2F99A4` | surfaces, borders, icons, chart series, display type ≥24px — 3.38:1, not a text colour at body size |67 | `--nr-primary-fill` | `#257880` | a filled surface carrying white text (5.15:1) |68 | `--nr-primary-text` | `#15585E` | links, labels, small type on white (8.11:1) |69 | `--nr-primary-deep` | `#0A5057` | hover for the above (9.14:1) |70 | `--nr-accent` | `#FF4D00` | accent as a fill or marker — 3.33:1, never body text |71 | `--nr-accent-dark` | `#CC3D00` | accent fill carrying white text (4.96:1) |72 | `--nr-accent-text` | `#9A2E00` | accent emphasis in text (7.60:1) |73 | `--nr-text` | `#585961` | body copy (6.96:1) |74 | `--nr-text-secondary` | `#6E6F78` | help, meta, captions (4.99:1) |75 | `--nr-bg` / `--nr-bg-alt` | `#FFFFFF` / `#F5F5F5` | page and section background |76 | `--nr-border` | `#CCCDCC` | dividers and decoration only (1.59:1) |77 | `--nr-border-strong` | `#8A8B93` | the visible boundary of an interactive control — SC 1.4.11 wants 3:1 |78 | `--nr-border-light` | `#E5E5E5` | hairlines |7980 Dark surfaces use a different set entirely — see `references/colors.md`.81- Accent orange is highlight-only and must not dominate surfaces82- Accessibility: WCAG AA minimum contrast and semantic structure83- Footer branding is mandatory in user-facing branded pages8485## TYPO3 Extension Requirements8687- Icon path: `Resources/Public/Icons/Extension.svg` (teal `#2F99A4`)88- Composer vendor prefix: `netresearch/`89- `author_company`: `Netresearch DTT GmbH`90- Description suffix: `- by Netresearch`91- Contact: `typo3@netresearch.de`9293## Brand Assets9495- `assets/markdown-pdf.css` — branded stylesheet for `markdown-to-pdf-skill`; apply via `--css`. Its `.page-header`/`.page-footer` running elements aren't emitted by `convert.py`; the caller must supply HTML containing them (see that skill's `SKILL.md`).96- `assets/markdown-pdf-logo.svg` — standalone Netresearch logo (brand-teal/grey) for general use.97- `assets/markdown-pdf-logo-white.svg` — white-fill variant for the `.page-header` running header, where the teal/grey logo has no contrast on the teal background (`--nr-primary`). The sanctioned exception to "no recoloring" — do not use elsewhere.9899## Licensing by artifact type100101"The Netresearch licence" is not one licence. Pick by what the artifact is:102103| Artifact | Licence |104|---|---|105| TYPO3 extension (`netresearch/t3x-*`, any `typo3-cms-extension`) | `AGPL-3.0-or-later`, or `GPL-2.0-or-later` where the extension must sit alongside GPL-2.0-only code — TYPO3 core is GPL-2.0-or-later and an extension inherits that obligation |106| Agent skill, library, CLI, internal tool | Split: code `MIT`, prose and reference content `CC-BY-SA-4.0`, shipped as `LICENSE-MIT` + `LICENSE-CC-BY-SA-4.0` with the SPDX expression `(MIT AND CC-BY-SA-4.0)` |107| Brand assets (logo files, colour specs, this skill's references) | `CC-BY-SA-4.0`, and the logo additionally carries the trademark rules in `references/logo.md` — a licence does not permit recolouring or distortion |108109Details for each: `references/typo3-extension-branding.md` for extensions,110`references/README-branding.md` for skills and tools.111112## No editorializing113114In branded reports, PR/commit text and docs, state what a change or output does, not how good the work is — no narrating expected results ("all tests green") or self-praise ("clean"). Judged by tone, not a wordlist. See `references/no-editorializing.md`.115116## References117118- `references/colors.md`119- `references/typography.md`120- `references/web-design.md`121- `references/logo.md`122- `references/logo-svg.md`123- `references/typo3-extension-branding.md`124- `references/README-branding.md`125- `references/no-editorializing.md`