Add LinkedIn Post Formatter skill and LinkedIn Post Writer agent 🤖🤖🤖

[sendtoshailesh]

Summary

This addresses the problem that Linkedin posts are text based and it adds a LinkedIn Post Formatter skill and a LinkedIn Post Writer agent for crafting engagement-optimized LinkedIn posts with Unicode bold/italic styling — directly from GitHub Copilot.

What's included

Skill: linkedin-post-formatter

• Location: skills/linkedin-post-formatter/
• Unicode bold (𝗯𝗼𝗹𝗱), italic (𝘪𝘵𝘢𝘭𝘪𝘤), and bold-italic (𝙗𝙤𝙡𝙙-𝙞𝙩𝙖𝙡𝙞𝙘) formatting reference
• 4 proven post structure patterns (Hook→Content→CTA, Listicle, Story→Lesson, Resource Share)
• Engagement optimization rules (hook above the fold, whitespace, CTAs, hashtags)
• Visual separator and bullet point conventions
• Bundled asset: references/unicode-charmap.md with complete A-Z, a-z, 0-9 character mapping

Agent: linkedin-post-writer

• Location: agents/linkedin-post-writer.agent.md
• 3-phase workflow: Analyze Input → Draft Post → Polish
• Auto-selects the best post pattern based on content type
• Transforms raw text, technical content, HTML files, or ideas into copy-paste-ready LinkedIn posts

Why this fills a gap

The existing Reepl LinkedIn agent requires a paid Reepl MCP server subscription for scheduling/analytics. This contribution is fully self-contained with zero external dependencies — focused purely on content formatting and drafting using Unicode typography that renders natively in LinkedIn's editor.

Testing

• Tested with GitHub Copilot CLI and VS Code Chat
• Validated formatting renders correctly when pasted directly into LinkedIn
• Skill passes npm run skill:validate
• README tables updated via npm start

[github-actions]

🔍 Skill Validator Results

⛔ Findings need attention

Scope	Checked
Skills	1
Agents	1
Total	2
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
⛔	Only one of --plugin, --skills, or --agents can be used at a time.

Full validator output

```text Only one of --plugin, --skills, or --agents can be used at a time. ```

> **Note:** The validator returned a non-zero exit code. Please review the findings above before merge.

[Copilot]

Pull request overview

Adds new self-contained LinkedIn content authoring resources to the repo: a LinkedIn Post Formatter skill (with a bundled Unicode charmap reference) and a LinkedIn Post Writer agent, plus documentation entries so they show up in the skills/agents indexes.

Changes:

• Added skills/linkedin-post-formatter/ with SKILL.md and a references/unicode-charmap.md asset.
• Added agents/linkedin-post-writer.agent.md defining a 3-phase LinkedIn post drafting workflow.
• Updated docs/README.skills.md and docs/README.agents.md to include the new skill/agent.

Show a summary per file

File	Description
skills/linkedin-post-formatter/references/unicode-charmap.md	Adds a Unicode mapping reference + symbols list for LinkedIn-style formatting.
skills/linkedin-post-formatter/SKILL.md	Defines the formatter skill’s rules, patterns, and formatting conventions.
agents/linkedin-post-writer.agent.md	Adds a dedicated agent for drafting/polishing LinkedIn posts using the conventions.
docs/README.skills.md	Registers the new skill in the skills index table.
docs/README.agents.md	Registers the new agent in the agents index table.

Copilot's findings

Comments suppressed due to low confidence (1)

skills/linkedin-post-formatter/SKILL.md:157

• This CTA example includes an emoji (👇), but the formatting rules above say “No emojis in body unless the user explicitly requests them.” Please either remove the emoji from the example CTA, or clarify that this is an opt-in example only when emojis are requested.

- **Closing CTAs that work**: "♻️ 𝗥𝗲𝗽𝗼𝘀𝘁 if...", "Save this for later", "Tag someone who needs this", "What's your take? 👇"
- **Whitespace is your friend**: Dense text gets scrolled past. Airy, scannable layout wins.

• Files reviewed: 5/5 changed files
• Comments generated: 3

[aaronpowell]

There are a few comments from Copilot that should be actioned before merging.

[sendtoshailesh]

Hi @aaronpowell — thanks for the review and approval! 🙏

All three Copilot review comments have been addressed in the latest push:

1. Unicode range header — corrected to include the separate digit range (U+1D7EC–U+1D7F5)
2. Charmap reference — added explicit instructions in SKILL.md to load references/unicode-charmap.md
3. LinkedIn casing — fixed the agent name field to use the display name "LinkedIn Post Writer" so the auto-generated README preserves correct brand casing

All CI checks are now passing (validate-readme, skill-check, codespell, check-line-endings). Ready for merge whenever convenient — happy to make any further adjustments if needed!