All skills

Write a LinkedIn post from a raw idea using 21 proven hook formulas, in the user's own voice, humanized so it does not read as AI. Use whenever the user wants a LinkedIn post, a hook, a draft for the feed, "post about X", "turn this into a LinkedIn post", or asks for hook options. Produces three hook options, one full draft, and a copy-ready block that is never published without an explicit yes.

Use this Skill: https://skilld.dev/gh/jakeschincariol/linkedin-agent-skill/li-post

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈102 tokens for metadata: the name and description. ≈972 when used: this file. ≈2.4k more on demand in 1 file.

Description uses 5.1% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈408 characters, or 5.1%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

li-post

Turns one raw idea into a LinkedIn post that sounds like the person who posted it.

Before you write

  1. Read ~/.claude/linkedin/voice.md if it exists. That file is the user's voice profile: how they talk, what they never say, who they are talking to. If it does not exist, ask for three of their own past posts, infer the voice from those, and write the file. Do not skip this and do not invent a voice. A post in the wrong voice is worse than no post.
  2. Read hooks.json in this folder. All 21 formulas, with templates, filled examples, what each is for, and how each one usually gets ruined.
  3. If the idea is thin - "post about AI" - do not pad it. Ask one batched question: what happened, to whom, and what did it cost or return. A post needs one specific true thing. Get it before writing.

The shape

LinkedIn rewards dwell time, saves and comments, in that order. So:

Line 1     the hook. Alone. It has to survive truncation at ~140 chars mobile.
Line 2     the payoff of line 1, not setup for line 3.
Body       short paragraphs, 1-3 lines each, blank line between every one.
           No wall. The white space is the format.
The turn   one line that reframes what came before.
Close      one specific question, or one instruction. Never both.

Length: 900-1,300 characters is the working range for a text post. Under 400 reads as a thought, not a post. Over 2,000 needs to earn every line, and the "see more" tap has to be paid for by line 2.

The loop

1. Pick three hooks, not one. Run the idea through hooks.json and choose the three formulas that genuinely fit it. Different formulas, not three variations of one. Show them as three numbered lines and say which you would ship and why, in one sentence.

2. Draft the full post on the strongest hook.

3. Humanize it. Run the draft through /li-human before showing it. Every post from this skill ships humanized. That is not an optional extra step, it is the reason the draft is worth reading.

4. Print the block. Copy-ready, in a fenced block, exactly as it should be pasted. Then, underneath:

POST READY
hook:      #17 Time Anchor
length:    1,140 characters
humanizer: 6 artefacts stripped, human score 84 PASS
post at:   Tuesday 8:15am ET (from your plan)

Reply "yes" to log it, or tell me what to change.

5. Never publish. This skill produces text. The user posts it. On "yes", append the post to ~/.claude/linkedin/log.md with the date, the hook used and the first line, so /li-audit has a history to work from later.

Rules that make the difference

  • One idea per post. If the draft has two, you have two posts. Say so.
  • Numbers over adjectives. "$4,200" beats "a lot". If the user has not given you a number, ask for one rather than writing around the hole.
  • No engagement bait. "Thoughts?" and "Agree?" are dead. The closing question has to be one only this post could ask.
  • Three hashtags maximum, at the bottom, and only if they are real categories someone follows.
  • No links in the post body. LinkedIn suppresses posts with outbound links. Put the link in the first comment and say so in the receipt.
  • Never fabricate. No invented metrics, clients, revenue figures or outcomes under the user's name, even as a placeholder. If a number is needed and unknown, leave {{your number}} in the draft and flag it.

Example

/li-post we built an internal tool that cut proposal time from 5 hours to 20 min
HOOKS
1. #17 Time Anchor    Writing a proposal used to take me 5 hours. It now takes 20 minutes.
2. #12 Comparison     A $12,000 proposal writer vs a weekend and a template. The weekend won.
3. #3  Mistake        For two years I charged clients for hours I was wasting on formatting.

Shipping #17: the ratio is believable and the number is yours.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts29d3 checks · Risk SAFE
  • Gen Agent Trust Hub29d

    This skill is a LinkedIn post writing assistant that uses a local voice profile and a JSON database of proven hook formulas. It operates entirely on text, avoids automatic publishing, and follows best practices for data storage and engagement. No security issues were detected.

  • Socket29d

    No alerts

  • Snyk29d

    Risk: LOW · No issues

Signed by skilld at add2c23. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 44 minutes ago.

Activeupdated last month

README badge

README badge for jakeschincariol/linkedin-agent-skill/li-post