Efficient Publisher LinkedIn

Generate professional LinkedIn posts from any content source with automatic media attachment, platform-specific formatting, and optional direct posting via LinkedIn API.

When to Use This Command

Run this command when you need to create a polished LinkedIn post from existing content with minimal effort.

• You published a blog post or article and want to promote it on LinkedIn
• You need a thought-leadership post with proper LinkedIn formatting and hashtags
• You want to attach images or PDFs to your LinkedIn post automatically
• You need to generate LinkedIn content in English or Japanese with appropriate tone

Use it also when:

• You want to post directly via LinkedIn API without visiting the web UI
• You need to escape LinkedIn's Little Text Format reserved characters correctly

Quick Start

Copy
# .claude/commands/efficient-publisher-linkedin.md
name: efficient-publisher-linkedin
description: Generate and optionally post LinkedIn content
arguments:
  input: Blog slug, file path, or URL

Copy
# Generate a LinkedIn post from a blog slug with auto-detected diagrams
claude efficient-publisher-linkedin "my-post-slug en"

Expected output:
LinkedIn Post Generated:
  Length: 1,847 characters
  Hashtags: #WebDevelopment #NextJS #DevOps
  Media: blog-diagram.png (auto-detected)

Preview saved: linkedin-draft-en.html
Opening browser for review...

Core Concepts

Concept	Description
Thought Leadership Tone	Professional, insight-driven writing style for English posts
Business Tone (keigo)	Formal Japanese business style using honorifics
Media Attachment	Image or PDF file attached to the LinkedIn post
Little Text Format	LinkedIn's markup system with reserved characters
API Posting	Direct posting via LinkedIn REST API with OAuth

LinkedIn Post Pipeline:
  Source ──> Parse Content ──> Generate Post ──> Escape Formatting
                                                       │
                              ┌────────────────────────┤
                              v                        v
                        Upload Media              Create Draft
                              │                        │
                              └──────> Post via API <──┘

Configuration

Parameter	Default	Description
input	required	Blog slug, file path, or URL
language	en	Target language: en or ja
media	auto-detect	Custom image or PDF file path
api-post	false	Post directly via LinkedIn API
hashtags	auto-generated	Number of hashtags (2-4 recommended)

Best Practices

1. Escape LinkedIn reserved characters -- Characters like | { } @ [ ] ( ) < > # * _ ~ must be escaped in the post body to avoid formatting issues.

2. Keep hashtags to 2-4 maximum -- LinkedIn's algorithm penalizes posts with too many hashtags. Choose the most relevant ones for your audience.

3. Use auto-detect for blog diagrams -- The command searches for images in your blog's asset directory and attaches the first relevant diagram automatically.

4. Generate without API first -- Even without LinkedIn API credentials, the command produces a ready-to-copy post. Set up API access later for automation.

5. Works in any repo -- This command uses only bash and curl, with no Node.js dependency. It works in Python, Rust, Go, or any other project type.

Common Issues

1. LinkedIn API token expired -- Access tokens have limited lifetimes. Re-run the OAuth flow by removing the token from .env and re-authenticating.

2. Media upload fails -- Only PNG, JPG, JPEG, and PDF formats are supported. Verify the file path and format before posting.

3. Post exceeds character limit -- LinkedIn posts have a 3,000 character limit. If the generated post is too long, the command truncates and adds a "read more" link.