Skip to content

Raise LinkedIn article word-count floor to 2,200w#42

Merged
cgallic merged 1 commit into
mainfrom
claude/linkedin-word-count-floor-ml4l47
Jul 6, 2026
Merged

Raise LinkedIn article word-count floor to 2,200w#42
cgallic merged 1 commit into
mainfrom
claude/linkedin-word-count-floor-ml4l47

Conversation

@cgallic

@cgallic cgallic commented Jul 6, 2026

Copy link
Copy Markdown
Owner

What & why

The default linkedin-article skill contract targeted 700–1,000 words, which is wrong for this channel. Per Connor's LinkedIn writing feedback, the LinkedIn article floor is 2,200 words. The deployed writer on the agent box was still generating to the stale 700–1,000w (its own prompt said 900–1,200w), so drafts came out far shorter than the channel warrants.

This PR raises the floor to 2,200 words and aligns every stale downstream target that fed generation off the old number, so the contract, the channel guide, and the writers all agree.

Changes

  • harness/skill-contracts/linkedin-article.yamlword_count 700-10002200-3000; word_count_range deterministic check raised to 2200 <= word_count <= 3000. This is the source of truth the writer derives its floor target from.
  • scripts/content/linkedin_article_writer.py (deployed agent-box writer) — prompt length 900–1,2002,200–3,000 (floor); max_tokens 20004500 so a 2,200w+ article is not truncated mid-generation.
  • scripts/content/_writer.py — engine linkedin format instruction 600-9002,200-3,000 (this format maps to the linkedin-article policy, so the old number contradicted the contract in-prompt).
  • knowledge/channels/linkedin-articles.md — length spec 1,200-2,0002,200-3,000 across the quick-reference table, checklists, and worked examples.
  • harness/skills/kai-repurpose/SKILL.md — LinkedIn article variant 700-10002,200-3,000.
  • harness/skill-contracts/social-post.yaml — article cross-reference comment updated to 2200-3000 (the LinkedIn organic-post range is unchanged).

Verification

  • python scripts/quality_gates/golden_check.py → 4/4 golden cases intact.
  • python scripts/doctor.py → harness intact (45/45 referenced files, instruction chain, gate scripts compile). Remaining warnings are pre-existing unconfigured-env warnings, unrelated to this change.
  • Confirmed the contract still parses and the writer's floor target resolves to 2200.

Note

The ceiling (3,000w) is not specified by the feedback — the feedback fixes only the 2,200 floor. I paired it with a 3,000 ceiling to keep a bounded range for the deterministic check and writer target (the prior contract and channel guide both used bounded ranges). Easy to widen if you'd prefer a higher or open-ended ceiling.

🤖 Generated with Claude Code

https://claude.ai/code/session_016dF1TwvB2u4jxSKhbyERr6


Generated by Claude Code

The default linkedin-article skill contract targeted 700-1,000 words, which
is wrong for this channel — per feedback the LinkedIn article floor is 2,200
words. Update the contract's word_count range and deterministic check, and
align every stale downstream target that fed generation off the old number:

- harness/skill-contracts/linkedin-article.yaml: word_count 700-1000 ->
  2200-3000; deterministic word_count_range check raised to 2200-3000
- scripts/content/linkedin_article_writer.py: prompt target 900-1,200 ->
  2,200-3,000 (floor); raise max_tokens 2000 -> 4500 so a 2,200w+ article
  is not truncated
- scripts/content/_writer.py: engine linkedin format instruction 600-900 ->
  2,200-3,000 (this format maps to the linkedin-article policy)
- knowledge/channels/linkedin-articles.md: length spec 1,200-2,000 ->
  2,200-3,000 across quick-ref, checklists, and worked examples
- harness/skills/kai-repurpose/SKILL.md: LinkedIn article variant 700-1000 ->
  2,200-3,000
- harness/skill-contracts/social-post.yaml: article cross-reference comment
  updated to 2200-3000

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016dF1TwvB2u4jxSKhbyERr6
@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
app-meetkai Ready Ready Preview, Comment Jul 6, 2026 11:39pm

Request Review

@cgallic cgallic marked this pull request as ready for review July 6, 2026 23:39
@cgallic cgallic merged commit c18b580 into main Jul 6, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants