skills/social-writer/SKILL.md
Create engaging content for social media platforms: X posts and threads, LinkedIn, Threads, Instagram, Facebook. Includes writing styles, AI-avoidance patterns, hooks catalog, and macOS Notes integration. Use when drafting social media posts, writing thread series, applying engagement hooks, or adapting content for specific platforms. Keywords: social media, X, LinkedIn, threads, posts, hooks, content strategy, AI writing avoidance.
npx skillsauth add itechmeat/llm-code social-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create platform-optimized social media content that sounds human, drives engagement, and builds audience.
| Topic | Reference | | --------------------- | ------------------------------------------------------- | | X Single Posts | x-posts.md | | X Threads | x-threads.md | | X Content Strategy | x-strategy.md | | Hook Patterns | hooks.md | | LinkedIn | linkedin.md | | Threads & Instagram | threads-instagram.md | | Facebook | facebook.md | | AI Writing Avoidance | ai-avoidance.md | | Style Guide | style-guide.md | | Technical Blog Styles | technical-styles.md |
| Platform | Limit | Best Length | Hashtags | Key Rule | | ------------- | ----------- | ----------- | -------- | ---------------------------------- | | X | 280 chars | 230-280 | 1-2 max | Hook in first line, use full space | | LinkedIn | 3,000 chars | 1,300 | 3-5 | Hook before "see more" | | Threads | 500 chars | 400-500 | None | Conversational, no hashtags | | Instagram | 2,200 chars | Varies | 5-15 | Visual-first, line breaks | | Facebook | Unlimited | <250 | 2-3 | Community, engagement |
What are you creating?
│
├─ X?
│ ├─ Single insight/observation → x-posts.md
│ ├─ Multi-part story/tutorial → x-threads.md
│ └─ Content planning → x-strategy.md
│
├─ LinkedIn → linkedin.md
│ └─ Professional, B2B, thought leadership
│
├─ Threads/Instagram → threads-instagram.md
│ └─ Conversational, authentic, visual
│
├─ Facebook → facebook.md
│ └─ Community, engagement, events
│
└─ Technical blog → technical-styles.md
├─ Karpathy style (conversational, personal)
└─ Deep technical (opinion-forward, contrarian)
Choose based on:
Before writing:
Apply platform constraints from start. Style informs structure.
Run through checklist below before posting.
[Hook - stop the scroll]
[Context or specific detail]
[Insight or learning]
[Optional: engagement question]
Example:
Shipped curation v1 for agents.foo today.
Discovery is way harder than app stores. Agents are conversations, not static features.
Had to rebuild around context matching instead of keyword search.
1/N [Bold hook - main insight] 👇
2/N [Context or setup]
3-N/N [Key points, one per tweet]
N/N [Summary + CTA]
Rules:
| Pattern | Structure | Best For | | ------------------------ | -------------------------------------------- | ------------------ | | Shipped X, Learned Y | What shipped + key learning + why it matters | Project updates | | How to X | Problem + steps + key insight | Tutorials | | Problem → Solution | Problem + failed attempts + what worked | Case studies | | Contrarian | Popular belief + why wrong + your evidence | Thought leadership | | Tool Recommendation | Tool + specific benefit + real example | Resources |
data-ai
Zvec in-process vector database. Covers collections, indexing, embeddings, reranking, and persistence. Use when embedding Zvec into applications or tuning retrieval/storage behavior. Keywords: Zvec, HNSW-RaBitQ, vector database, ANN.
development
Vitest testing framework: Vite-powered tests, Jest-compatible API, mocking, snapshots, coverage, browser mode, and TypeScript support. Use when writing or configuring tests with Vitest, setting up mocking/snapshots, configuring coverage, or running browser-mode tests. Keywords: Vitest, testing, Vite, Jest, mocking, coverage.
tools
Vite next-gen frontend tooling: dev server, HMR, build, config, plugins, Environment API, Rolldown. Use when setting up or running a Vite project, configuring vite.config.*, authoring plugins, working with HMR or JS API, or managing environment variables and modes. Keywords: vite.config, bundler, Vite, HMR, Rolldown.
development
Orchestrate AI coding with Vibe Kanban: tasks, review, sessions, workspaces, and isolated git worktrees. Use when managing AI-generated code in isolated environments, planning coding tasks, reviewing AI output, or configuring Vibe Kanban workspaces and agents. Keywords: Vibe Kanban, AI orchestration, worktrees.