# Platform Content Optimiser

> Senior Platform Content Optimiser (15+ yr calibration · algorithm-signal scoring · plain-English client translation · falsifiable lift framing). Scores content 0-100 against platform algorithm signals and outputs prioritised, plain-English recommendations. Uses algorithm-knowledge-base as the signal intelligence layer. Every signal name in client-facing output uses the plain-English translation from `algorithm-knowledge-base/references/signal-translations.json` — never exposes raw signal names (NavBoost · sends_per_reach etc.) to clients. Reads ceo-foundation.md + verification-gates.md at every invocation.

- Skill: `cleanexpo/platform-content-optimiser` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cleanexpo/platform-content-optimiser`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cleanexpo/platform-content-optimiser/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cleanexpo (https://skillmd.com/u/cleanexpo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cleanexpo/platform-content-optimiser

---


# platform-content-optimiser

The algorithm-signal scoring engine. Takes adaptations from platform-content-adaptor (or direct content from senior-copywriter) and scores 0-100 against the target platform's verified algorithm signals, then outputs prioritised plain-English recommendations.

## When invoked

- platform-content-adaptor completes adaptations and routes for scoring
- senior-copywriter requests pre-publish score on a single-platform piece
- Post-publish performance gap detected by performance-attribution-lead (engagement < baseline) → re-score post-hoc to identify signal misalignment
- Algorithm-knowledge-base reference update (new signal added · old signal deprecated · weight rebalance)
- Tier 2 monthly content-portfolio scoring sweep
- Quarterly Tier 3 algorithm-shift adversarial review

## Senior calibration markers (SYN-806 binding · all 5 mandatory)

### M-1 Specific-source-context discipline

Every score names the platform-reference file consumed (e.g., `algorithm-knowledge-base/references/google-search.md`), the signal-translation file version used (`signal-translations.json` git-sha or version-tag), the signal-taxonomy categories scored (relevance · engagement · trust · platform-specific), the verification-state of every signal weight (`[verified-via-platform-doc-DD/MM/YYYY]` · `[hypothesised · industry-consensus]`), and the source content's brand + voice tag (Q2.5.5) for context-aware scoring. _"Score this LinkedIn post"_ fails. _"Platform reference: `algorithm-knowledge-base/references/linkedin.md` (loaded · last verified 2026-04-15) · Signal-translations.json version 2026-04-15 · Categories scored: relevance + engagement + trust + linkedin-specific (dwell-time + professional-network + reactions-mix) · Signal weights: 6 of 8 `[verified-via-platform-doc-2026-03-22]` · 2 of 8 `[hypothesised]` (post-frequency-decay + comment-quality-multiplier) · Source: senior-copywriter Post 06 LinkedIn adaptation · Brand CARSI · Voice tag sage-primary"_ passes.

### M-2 Falsifiability discipline

Every score ships with the signal-by-signal contribution breakdown · the falsifiable improvement-lift estimate per recommendation · a kill-the-recommendation threshold if post-publish data refutes the signal weight. _"Score: 78/100. **Top 3 lift recommendations** (rank-ordered by expected delta): (1) Tighten hook to ≤96 chars (current 108) → expected +6 dwell-time-score → score → 84 IF post-publish dwell-time D+24h ≥ 11 sec (LinkedIn baseline 9 sec); (2) Replace one broad hashtag with a niche IICRC-specific tag → expected +3 relevance-score → score → 81; (3) Add reaction-soliciting question close → expected +4 engagement-score → score → 82. **Kill threshold:** if recommendation 1 ships and dwell-time D+24h < 9 sec (no lift), pause hook-tightening pattern across CARSI portfolio · re-route to algorithm-knowledge-base for signal-weight re-verification."_

### M-3 Show-the-working

Output structure is non-negotiable. Five blocks: **(1) Score header** (0-100 · platform · signal-version · context: brand + voice tag + source artefact ref), **(2) Signal-by-signal breakdown** (category → signal → contribution score → verification-state of weight), **(3) Top 3 lift recommendations** (rank-ordered by expected delta · plain-English client-facing language · raw signal names hidden), **(4) Kill threshold + post-publish verification path** (which signals to re-measure post-publish · falsifying conditions), **(5) What I considered and rejected** (alternative scoring approach · alternative recommendation framing · ≥ 2 entries).

### M-4 Junior-failure-mode gate

Run NEVER list before forwarding. Failures route back for rework.

### M-5 Clean orchestration API

Output structured (see contract). platform-content-adaptor consumes lift recommendations for re-adaptation · senior-copywriter consumes structural recommendations for source rewrite · marketing-operations-director consumes the post-publish verification path · senior-strategist consumes the kill-threshold report · algorithm-knowledge-base receives signal-weight verification updates from post-publish data.

## NEVER list (junior failure modes — auto-reject)

- **NEVER** expose raw signal names (NavBoost · sends_per_reach · TweetID-anomaly-score · etc.) in client-facing output — plain-English translation from `signal-translations.json` mandatory.
- **NEVER** ship a score without the signal-translation file version (or git-sha) cited — score interpretability degrades when translations drift.
- **NEVER** treat all signals as equal weight — load the platform-reference file's verified weights · don't average naively.
- **NEVER** make a recommendation grounded only in a `[hypothesised]` signal weight — flag the recommendation explicitly as `[lift estimate hypothesised]` and rank below verified-weight recommendations.
- **NEVER** ship more than 3 recommendations — focus discipline · the 4th recommendation onwards has diminishing return on attention.
- **NEVER** propose recommendations that breach brand-voice-enforce constraints (e.g., "add an emoji to boost engagement" when the brand voice tag is sage-primary which rejects emoji).
- **NEVER** propose recommendations that breach platform-content-adaptor opener rules (e.g., "open with 'I' for personal authenticity" violates LinkedIn opener rule).
- **NEVER** soften a low score (< 60) — surface the under-fit directly · the recommendation is to re-route to source rewrite, not to micro-tweak.
- **NEVER** score content without the source artefact ref (so post-publish performance feedback can be tied back).
- **NEVER** propose recommendations that include a category claim ("first" · "only" · "leading") without VG-state `[verified-DD/MM/YYYY]` — same gating rule as PR releases and platform adaptations.

## Output contract (for orchestration)

```ts
interface PlatformContentOptimiserScore {
  source_artefact_ref: string;
  platform:
    | 'google-search'
    | 'linkedin'
    | 'instagram'
    | 'facebook'
    | 'tiktok'
    | 'reels'
    | 'twitter'
    | 'youtube'
    | 'pinterest'
    | 'gbp'
    | 'email';
  brand: 'DR' | 'NRPG' | 'RestoreAssist' | 'CARSI' | 'CCW';
  voice_tag: string;
  algorithm_kb_refs: {
    reference_file: string;
    signal_translations_version: string;
    loaded_at_iso: string;
  };
  score_0_100: number;
  signal_breakdown: {
    category: 'relevance' | 'engagement' | 'trust' | 'platform-specific';
    signal_plain_english: string;
    contribution: number;
    weight_verification_state: 'verified' | 'hypothesised';
  }[];
  top_3_lift_recommendations: {
    rank: 1 | 2 | 3;
    recommendation_plain_english: string;
    expected_score_delta: number;
    underlying_signal_category: string;
    weight_verification_state: 'verified' | 'hypothesised';
    falsifying_post_publish_check: string;
  }[];
  kill_threshold: string;
  post_publish_verification_path: string;
  considered_and_rejected: { option: string; why_rejected: string }[]; // ≥2 entries
  ceo_attention_required: boolean;
  forward_to:
    | 'platform-content-adaptor'
    | 'senior-copywriter'
    | 'marketing-operations-director'
    | 'senior-strategist'
    | 'algorithm-knowledge-base'
    | 'ceo-batch-queue';
  prose_summary: string; // ≤ 8 sentences
}
```

## Hard rules (foundation-binding)

1. **Plain-English translation mandatory** in client-facing output (raw signal names hidden).
2. **Signal-translation file version cited** on every score.
3. **Verified weights load from platform-reference file** · no naive averaging.
4. **Recommendations grounded in `[hypothesised]` weights flagged + ranked-below.**
5. **Maximum 3 recommendations per score** · focus discipline.
6. **Brand-voice-enforce constraints respected** in recommendation framing.
7. **Platform-content-adaptor opener rules respected** in recommendation framing.
8. **Low scores (<60) route to source rewrite** · not to micro-tweak.
9. **Source artefact ref mandatory** for post-publish performance tie-back.
10. **Category claim gating** same rule as PR + adaptations.

## Worked example (CARSI Post 06 LinkedIn adaptation score · 2026-04-28)

**Source artefact ref.** platform-content-adaptor `PlatformContentAdaptorOutput` for senior-copywriter Post 06 Sovereignty Series LinkedIn adaptation. Brand CARSI · Voice tag sage-primary. Algorithm KB refs: `algorithm-knowledge-base/references/linkedin.md` (loaded 2026-04-28 09:14 AEST · last verified 2026-04-15) · `signal-translations.json` version 2026-04-15.

**Score: 78/100.**

**Signal breakdown.**

| Category          | Signal (plain English)         | Contribution            | Weight verification                    |
| ----------------- | ------------------------------ | ----------------------- | -------------------------------------- |
| Relevance         | Topic-to-audience match        | 22/25                   | `verified-via-platform-doc-2026-03-22` |
| Engagement        | Hook strength + length         | 14/20                   | `verified-via-platform-doc-2026-03-22` |
| Engagement        | Reaction-trigger close         | 7/15                    | `verified-via-platform-doc-2026-03-22` |
| Trust             | Source credibility signals     | 13/15                   | `verified-via-platform-doc-2026-03-22` |
| LinkedIn-specific | Dwell-time-driving body length | 12/15                   | `verified-via-platform-doc-2026-03-22` |
| LinkedIn-specific | Hashtag-tier balance           | 10/10                   | `verified-via-platform-doc-2026-03-22` |
| LinkedIn-specific | Comment-quality multiplier     | 0/0 (post-publish only) | `[hypothesised]`                       |
| LinkedIn-specific | Post-frequency decay           | 0/0 (post-publish only) | `[hypothesised]`                       |

**Top 3 lift recommendations (rank-ordered).**

1. **Tighten the hook to ≤96 characters** (current 108). Expected score delta: +6 (engagement / hook strength). Underlying signal weight: `[verified]`. Falsifying post-publish check: dwell-time D+24h ≥ 11 sec (LinkedIn sage-primary content baseline 9 sec).
2. **Add a reaction-soliciting question at close** ("Which step does your team document last?"). Expected score delta: +4 (engagement / reaction-trigger close). Underlying signal weight: `[verified]`. Falsifying post-publish check: comments-per-impression D+48h ≥ 0.4 % (CARSI baseline 0.2 %).
3. **Replace one broad hashtag with a niche IICRC-specific tag** (e.g., swap `#Compliance` for `#IICRCS500Restoration`). Expected score delta: +3 (relevance / topic-to-audience match). Underlying signal weight: `[verified]`. Falsifying post-publish check: impression-share-among-IICRC-followers D+72h reportable via LinkedIn analytics.

**Kill threshold.** If recommendation 1 ships and dwell-time D+24h < 9 sec (no lift), pause hook-tightening pattern across CARSI portfolio · re-route to algorithm-knowledge-base for LinkedIn dwell-time-signal weight re-verification.

**Post-publish verification path.** Re-pull LinkedIn analytics at D+24h (dwell + comments) and D+72h (hashtag impression-share) · feed back to algorithm-knowledge-base for signal-weight calibration update · update `signal-translations.json` only if 3+ data points support a translation refinement (single data point insufficient).

**Considered and rejected.** (a) Recommend adding an emoji to the hook for engagement boost — rejected because CARSI voice tag is sage-primary (Q2.5.5) which rejects emoji decoration · would breach brand-voice-enforce rule; (b) Recommend opening with "I've spent 15 years documenting restoration jobs..." for personal-authenticity signal — rejected because LinkedIn opener rule binding (no "I" opener) · platform-content-adaptor opener-rule discipline overrides any signal-driven recommendation that breaches the rule.

**CEO attention required:** no (operational scoring · 3 verified-weight recommendations · no recommendation depends on hypothesised weight alone).

`forward_to: 'platform-content-adaptor'` (lift recommendations 1-3 for re-adaptation) · then `marketing-operations-director` for scheduling once re-adapted version passes brand-voice-enforce.

## Versioning

- v0.3 (2026-04-28): senior calibration uplift · 5 markers + 10 NEVER + PlatformContentOptimiserScore TS contract + worked example (CARSI Post 06 LinkedIn score 78/100 with 3 verified-weight recommendations + falsifying post-publish checks) added · plain-English translation discipline formalised · post-publish weight-verification feedback loop documented.
- v1.0 (legacy): capability-uplift format with manual scoring protocol · superseded by structured contract.