simonpaag/.agents/skills/cphport-tone

CPHport Tone of Voice & Content Guidelines

When writing content for the CPHport platform, including Services, Companies, News Articles, and Categories, strict adherence to these guidelines ensures a cohesive, professional B2B experience.

Tone of Voice

1. Lexical and Objective: The tone must be informative, factual, and encyclopedia-like. It is addressing shipping-professionals, forwarders, brokers, and captains.
2. Highly Professional: Maintain a distinguished and serious maritime profile.
3. Non-Salesy: Avoid excessive marketing fluff, hyperbolic adjectives ("world-class", "unbelievable"), and hard-selling language. Focus on technical capabilities, capacities, and compliance.
4. Maritime & Technical: Use correct industry terminology (e.g., TEU, ISPS, draft, stevedoring, MARPOL, ROV). State facts clearly.

Structure & Formatting

1. Bilingual Requirement: All core content MUST be provided in both English (_en) and Danish (_da).
2. Length Requirement: content_en and content_da are meant to be deeply educational "premium" pages. They MUST each be highly detailed and at least 1500 characters long.
3. HTML Formatting in Content Fields: The content_en and content_da fields in the database are rendered directly as HTML.
   • You MUST format the main body text using pure HTML tags.
   • Use <h3> for main subtitles within the text (e.g., <h3>About Pilotage Services</h3>).
   • Use <h4> for secondary sections (e.g., <h4>Key Operational Aspects</h4>).
   • Use <p> for paragraphs.
   • Use <ul> and <li> for lists of capabilities or features.
   • Use <strong> within list items for the leading concept.
   • NEVER use Markdown (#, **, *) in the content_en and content_da fields.

Metadata & Descriptions

• Descriptions: The description_en and description_da fields are used for SEO meta tags and overview cards. They must be plain text (no HTML), concise, and strictly limited to 1-2 summarizing sentences.

Data Structure (Standard JSON Output)

When generating content to be ingested into the CPHport database, format it as a strict JSON array utilizing these exact keys:

```json [ { "title": "Topic Name (English)", "description_en": "Concise meta description (max 2 sentences)", "description_da": "Kort meta-beskrivelse (max 2 sætninger)", "content_en": "<h3>About Topic</h3><p>Factual text...</p><h4>Key Aspects</h4><ul><li><strong>Aspect:</strong> Details</li></ul>", "content_da": "<h3>Om Emnet</h3><p>Faktuel tekst oversat til dansk...</p><h4>Nøgleaspekter</h4><ul><li><strong>Aspekt:</strong> Detaljer</li></ul>" } ] ```