convez.ai
SkillEscrita & ConteúdoIntermediário
IreneYe08

LinkedIn Smart Formatter

IreneYe08/linkedin-smart-formatter

Converta rascunhos LinkedIn em posts formatados, pronto para colar

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de formatação inteligente de posts LinkedIn que transforma rascunhos brutos em conteúdo pronto para colar, com hooks, negrito, listas, espaçamento mobile e hashtags automáticas. Funciona localmente em Cursor, Claude Code, Cortex Workspace e CLI, sem APIs externas.

Instalação

$npx convez-ai IreneYe08/linkedin-smart-formatter

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Polir posts LinkedIn direto no agent de IA durante escrita
  • Aplicar formatação Unicode (bold/italic) e layout mobile automaticamente
  • Gerar hashtags relevantes e destacar teses principais em posts de conteúdo profissional

Veredito

Ferramenta prática e bem executada para quem escreve no LinkedIn via agents de IA. Resolve um pain point real (formatação + layout) com uma abordagem local e reproduzível, sem dependências de API. Útil para creators e profissionais que querem agilizar o fluxo de publicação.

README

A tradução para o português deste README ainda está na fila.

LinkedIn Smart Formatter

Turn rough LinkedIn drafts into paste-ready posts — inside Cursor, Claude Code, Cortex Workspace, or any CLI agent.

Same Python engine, thin skill adapters per platform. No browser tab. No API keys. Runs locally.

Python 3.8+ License: MIT

Before & After

Real post from a rough draft — smart hook promotion, spacing, bold thesis, bullet list, plain-text report title, auto hashtags.

Before (wall of text)After (paste-ready)
Before: dense paragraph draft on LinkedInAfter: formatted hook, lists, spacing, hashtags

What changed: punchy hook moved to top · The remaining challenge is workflow fragmentation bolded · workflow steps as bullets · blank lines for mobile · engagement question preserved · #Accounting #AI #Finance … auto-added · report title "Best AI Tools for Accountants 2026" kept plain ASCII (no broken Unicode italic).

Why this exists

LinkedIn has no native bold/italic in feed posts. Tools like Typegrow use Unicode character mapping — this project does the same, plus smart layout:

  • Promote a punchy hook above a long opener
  • Bold thesis lines (The challenge is …)
  • Bullet lists, stat emphasis, engagement questions
  • Auto-suggest hashtags (plain ASCII, footer)
  • Keep report titles "Best Tools 2026" in plain text (fixes editor cursor bugs)

Built for AI coding players who write posts in Agent chat and want copy-paste output.

Quick start (CLI)

git clone https://github.com/IreneYe08/linkedin-smart-formatter.git
cd linkedin-smart-formatter

python scripts/linkedin_post.py --self-test
python scripts/linkedin_post.py --file examples/draft-accounting-ai.txt --count --explain

Copy stdout → LinkedIn composer.

Install for your Agent

One repo, multiple platforms:

PlatformInstall pathSkill location
Cursor./install.sh or install.ps1~/.cursor/skills/linkedin-text-formatter
Claude Codesame~/.claude/skills/linkedin-text-formatter
Cortex Workspacededicated repo (recommended) or cortex/ in this repo~/.cortex/skills/linkedin-text-formatter
Codex / CLI agentspaste snippetskills/codex/AGENTS.snippet.md → your AGENTS.md

macOS / Linux

git clone https://github.com/IreneYe08/linkedin-smart-formatter.git ~/linkedin-smart-formatter
cd ~/linkedin-smart-formatter
./install.sh

Windows (PowerShell)

git clone https://github.com/IreneYe08/linkedin-smart-formatter.git $env:USERPROFILE\linkedin-smart-formatter
cd $env:USERPROFILE\linkedin-smart-formatter
.\install.ps1
py -3 scripts\linkedin_post.py --self-test

Install writes ~/.linkedin-formatter-home so agents resolve the CLI path automatically.

Cortex Workspace (full edition)

Recommended: use the dedicated Cortex repo — clone straight into your skills folder:

git clone https://github.com/IreneYe08/linkedin-text-formatter-cortex.git $env:USERPROFILE\.cortex\skills\linkedin-text-formatter

Includes scripts + 8-block post guidelines + anti-AI writing rules.

Alternatively, copy cortex/ from this monorepo (kept in sync for convenience).

Details: cortex/README.md · linkedin-text-formatter-cortex

Agent workflow

User pastes draft
    → Agent saves to temp file
    → python scripts/linkedin_post.py --file draft.txt --count --explain
    → Agent returns formatted post + layout summary

See skills/_shared/workflow.md.

What smart layout does

SignalAction
Long line 1 + short punchy line 2Move hook to top
Hook / thesis / Title: headersUnicode bold (sans)
- items / 1. / [ ]Lists
40%, 3x, $10kBold metric (+ Unicode digits)
Closing where do you…?Italic
"Report 2026" reportPlain ASCII quotes
Keywords in bodyAuto hashtags (max 5, footer)

Full rules: docs/layout-rules.md

CLI flags

--count --explain          Show char count + layout log
--less-bold                Hook only — skip section headers
--no-hashtags              Disable auto hashtags
--hashtags 3               Limit footer tags
--no-promote-hook          Keep original line order
--self-test                Run regression tests

Project layout

linkedin-smart-formatter/
├── scripts/           # Python engine (stdlib only)
│   └── linkedin_post.py   ← entry point
├── skills/
│   ├── cursor/        # Cursor Agent Skill
│   ├── claude-code/   # Claude Code Skill
│   ├── cortex/        # Cortex Workspace Skill
│   └── codex/         # AGENTS.md snippet
├── docs/
├── examples/
├── install.sh
└── install.ps1

Important limitations

TopicDetail
Not officialNot affiliated with LinkedIn, Typegrow, Cursor, Anthropic, or Cortex
SearchUnicode 𝗯𝗼𝗹𝗱 ≠ searchable bold — don't bold keywords
AccessibilityScreen readers struggle with Unicode styled letters
Char limitStyled chars count ~2× toward LinkedIn's ~3000 limit
Privacy100% local — drafts never leave your machine

Details: docs/reference.md

Extend

  • Hashtags: edit scripts/hashtags.py — add (regex, "#Tag", priority) rules
  • Layout heuristics: edit scripts/smart_layout.py
  • New platform: copy skills/cursor/SKILL.md → skills/your-platform/

Contributing

PRs welcome. Run python scripts/linkedin_post.py --self-test before submitting.

License

MIT — see LICENSE


Made for AI builder workflows · Cortex Workspace friendly

Ver o original no GitHub

Bom para

Relacionados