# LinkedIn writer Human Guide

## What This Is For
Purpose Generate 2 viral LinkedIn posts in different proven formats, matched to the founder's voice, using battle-tested templates and patterns that drive engagement on LinkedIn. It gives the agent a clearer input/output frame for social content: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the LinkedIn writer agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for LinkedIn writer.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the LinkedIn writer guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- **linkedin-formats.md**: 7 proven LinkedIn post formats with structure templates, psychology, rules, and when-to-use matching logic
- **linkedin-posts.md**: 8+ proven viral LinkedIn posts organized by format type — the example and voice library
- **If it exists:** Read it and use the business context to personalize output (industry terminology, audience pain points, brand voice, company name, products, achievements).
- **If it doesn't exist:** Proceed using defaults from "Defaults & Assumptions."
- **Topic/idea** — What they want to post about
- **Goal** — What they want the post to achieve (engagement, authority, leads, thought leadership)
- **Any specific format preference** — If they mentioned a format type
- **Study the example posts** in linkedin-posts.md for your selected formats — internalize the rhythm, structure, hook style, and length
- **Extract the voice DNA** from the reference posts — match the writing style:
- Conversational and direct, like talking to a peer
- Short paragraphs (1-3 sentences each)
- Heavy line breaks for readability

## Decision Points And Nuance
The original skill emphasizes: Purpose, Execution Logic, If $ARGUMENTS is empty or not provided:, If $ARGUMENTS contains content:, Task Execution, MANDATORY: Read Reference Files FIRST, Check for Business Context, Analyze Input & Auto-Select Formats, Generate 2 Viral LinkedIn Posts, Format and Verify.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- BLOCKING REQUIREMENT — DO NOT SKIP THIS STEP
- Before doing ANYTHING else, you MUST use the Read tool to read ALL reference files. This is non-negotiable:
- **DO NOT PROCEED** to Step 2 until you have read all files and have their content in context.
- Each post must use a DIFFERENT format (no repeats)
- Each post must match the voice DNA from the reference posts
- Each post must be about the user's SPECIFIC topic (not generic advice)
- Each post must follow the format's structure template from linkedin-formats.md
- Each post must be ready to copy-paste and post immediately — no placeholders, no [brackets], no instructions

## Copy-And-Paste Prompt
```text
Use the LinkedIn writer human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the ognjengt/founder-skills skill entry for `linkedin-writer`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# LinkedIn Writer

## Purpose
Generate 2 viral LinkedIn posts in different proven formats, matched to the founder's voice, using battle-tested templates and patterns that drive engagement on LinkedIn.

---

## Execution Logic

**Check $ARGUMENTS first to determine execution mode:**

### If $ARGUMENTS is empty or not provided:
Respond with:
"linkedin-writer loaded, proceed with your topic or idea"

Then wait for the user to provide their requirements in the next message.

### If $ARGUMENTS contains content:
Proceed immediately to Task Execution (skip the "loaded" message).

---

## Task Execution

When user requirements are available (either from initial $ARGUMENTS or follow-up message):

### 1. MANDATORY: Read Reference Files FIRST
**BLOCKING REQUIREMENT — DO NOT SKIP THIS STEP**

Before doing ANYTHING else, you MUST use the Read tool to read ALL reference files. This is non-negotiable:

```
Read: ./references/linkedin-formats.md
Read: ./references/linkedin-posts.md
```

**What you will find:**
- **linkedin-formats.md**: 7 proven LinkedIn post formats with structure templates, psychology, rules, and when-to-use matching logic
- **linkedin-posts.md**: 8+ proven viral LinkedIn posts organized by format type — the example and voice library

**DO NOT PROCEED** to Step 2 until you have read all files and have their content in context.

### 2. Check for Business Context
Check if `FOUNDER_CONTEXT.md` exists in the project root.
- **If it exists:** Read it and use the business context to personalize output (industry terminology, audience pain points, brand voice, company name, products, achievements).
- **If it doesn't exist:** Proceed using defaults from "Defaults & Assumptions."

### 3. Analyze Input & Auto-Select Formats
From the user's requirements, extract:
- **Topic/idea** — What they want to post about
- **Goal** — What they want the post to achieve (engagement, authority, leads, thought leadership)
- **Any specific format preference** — If they mentioned a format type

**Format Auto-Selection Logic:**

If the user specified a format → use that format for one post, auto-select the best complementary format for the second.

If the user did NOT specify a format, auto-select 2 different formats based on the topic:

| If the topic involves... | Best format match |
|---|---|
| Multiple tips, lessons, mistakes, or advice points | **Lessons Learned** |
| A complete process, roadmap, or "how to achieve X" | **Actionable Blueprint** |
| A personal experience, failure, setback, or pivotal moment | **Personal Story** |
| Explaining one specific technique, hack, or strategy with proof | **Strategy Breakdown** |
| Analyzing a specific company, product, or brand | **Case Study** |
| A strong opinion, industry trend, prediction, or contrarian view | **Industry Hot Take** |
| A small but impactful tip or optimization | **Quick Hack** |

**Always select 2 DIFFERENT formats.** Choose the primary format based on the strongest topic match, then select a complementary second format that gives the user a different angle on the same topic.

### 4. Generate 2 Viral LinkedIn Posts
Using the formats and posts you loaded in Steps 1-3:

1. **Study the example posts** in linkedin-posts.md for your selected formats — internalize the rhythm, structure, hook style, and length
2. **Extract the voice DNA** from the reference posts — match the writing style:
   - Conversational and direct, like talking to a peer
   - Short paragraphs (1-3 sentences each)
   - Heavy line breaks for readability
   - Mixes professional insight with personality