postemi 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,221 @@
1
+ ---
2
+ name: postemi-growth
3
+ description: Grow an audience and get results from social posting with Postemi. Covers choosing networks and a first niche, a 30-day posting test, reading the numbers (Postemi Insights and analytics), posting cadence per network, turning one topic into 30 post angles and scheduling them as a content plan, repurposing one idea across networks, bios and profile links that turn followers into sign-ups or customers, and a weekly review loop. Use when the user asks how to grow followers or reach, what or how often to post, for a content plan or calendar, why posts do not perform, or how to get customers from social media.
4
+ ---
5
+
6
+ # Postemi growth: from posting to results
7
+
8
+ This skill is the plan; `postemi-writing` is how each post is written,
9
+ `postemi-templates` has ready drafts, and the main `postemi` skill has the
10
+ tools and commands. If the writing skills are not installed, write the posts
11
+ with the rules of the main skill and offer `postemi skills add writing` (ask
12
+ the user first). Reference files:
13
+
14
+ - [reference/30-angles.md](./reference/30-angles.md): 30 ways to post about
15
+ one topic, with a worked example.
16
+ - [reference/review.md](./reference/review.md): the post log and the weekly
17
+ review, step by step.
18
+
19
+ ## Principles
20
+
21
+ 1. **Focus.** One or two networks done well beat seven done badly. Add more
22
+ once something works.
23
+ 2. **Every post is a test.** Growth early on is learning what this audience
24
+ wants. Post, read the numbers, keep what works, drop what does not.
25
+ 3. **Consistency beats bursts.** A steady rhythm the user can keep for months
26
+ wins over a busy week followed by silence. Long gaps cost reach.
27
+ 4. **Big changes, not tiny tweaks.** With a small audience, a new topic, angle
28
+ or format teaches more than changing one word.
29
+ 5. **Real engagement only.** No bought followers, no engagement swaps, no
30
+ bots. Comments, shares, saves and replies from real readers are the signal.
31
+ 6. **What Postemi does and does not do.** Postemi writes nothing on its own,
32
+ schedules and publishes, and shows numbers. It does not reply to comments,
33
+ follow, connect, like or send messages for the user. Those are the user's
34
+ part, and they matter.
35
+
36
+ ## 1. Choose where to start
37
+
38
+ Ask who the user wants to reach and what they sell or share, then suggest one
39
+ main network and at most one second one:
40
+
41
+ | The user | Start with |
42
+ |---|---|
43
+ | Sells to businesses, consultant, founder, job market | LinkedIn (personal profile), then X |
44
+ | Ideas, tech, writing, building in public | X or Threads, then LinkedIn; Bluesky for tech crowds |
45
+ | Visual products, food, fashion, beauty, travel, places | Instagram (Reels and carousels), then TikTok |
46
+ | Local business (shop, cafe, salon, trades) | Facebook and Instagram |
47
+ | Teaching with video | YouTube (Shorts too) and TikTok |
48
+ | An existing community | Telegram, Discord or Slack, next to one public network |
49
+
50
+ Postemi can send the same idea to several networks at once later (section 6),
51
+ so starting narrow costs nothing.
52
+
53
+ ## 2. The first niche and the 30-day test
54
+
55
+ A niche is not for life; it is the first topic the user goes deep on. The
56
+ skill of building an audience carries over when the topic changes. Find it
57
+ with data, not by thinking harder:
58
+
59
+ 1. **Pick one network** (usually X or LinkedIn for text, Instagram or TikTok
60
+ for visuals).
61
+ 2. **Post at least once a day for 30 days.** Any idea from the user's
62
+ experience: use the idea builder and the look-back test in
63
+ `postemi-writing`. Vary topic, angle (how-to, analysis, inspiration, human
64
+ nature) and format on purpose, so the data has something to compare.
65
+ 3. **Schedule it with Postemi a week at a time.** Write seven posts with the
66
+ user, preview them, and create them in one go (one `socialPost` entry per
67
+ day in `create_post`, or a `--json` file with the CLI). The user only has
68
+ to show up for the replies.
69
+ 4. **Log every post** (topic, angle, format, hook, time): see
70
+ [reference/review.md](./reference/review.md).
71
+ 5. **After 30 days, read the numbers** (section 3) and pick the topic and the
72
+ angle with the strongest early signal.
73
+ 6. **Go deep on that topic** for the next weeks. Writing about the same topic
74
+ again and again is not repetition; it is why people follow someone. The 30
75
+ angles (section 5) make it easy.
76
+
77
+ Small numbers still count. If 20 posts got no likes and 10 got one, those 10
78
+ did infinitely better: that is the signal. The method is the same at 10
79
+ followers and at 10,000; only the zeros change.
80
+
81
+ ## 3. Read the numbers
82
+
83
+ Where the numbers are:
84
+
85
+ - **Postemi Insights**, in the web app (postemi.com/app/insights): reach,
86
+ engagement and followers per channel over time.
87
+ - **The CLI:** `postemi analytics:platform <integration-id> -d 30` for a
88
+ channel, `postemi analytics:post <post-id> -d 7` for one post. If a post
89
+ answers `{"missing": true}`, link it first (`posts:missing`, then
90
+ `posts:connect`; see the main skill).
91
+ - **The MCP tools** have no analytics tool. Ask the user to open Insights, or
92
+ to paste or screenshot the numbers, and work from that. `list_posts` gives
93
+ the post ids, dates and channels to match them to.
94
+ - The network's own analytics, when the user has it open.
95
+
96
+ What to look at, in this order:
97
+
98
+ 1. **Conversations:** comments and replies (and how long they are). The
99
+ strongest sign a post landed.
100
+ 2. **Shares, reposts and saves:** people found it worth passing on or keeping.
101
+ 3. **Follows and profile visits** after a post: it made people want more.
102
+ 4. **Engagement rate:** engagements divided by impressions. Compares posts
103
+ fairly when reach differs.
104
+ 5. **Reach and impressions:** how far it went. Useful, but a post can travel
105
+ far and change nothing.
106
+ 6. **Clicks and sign-ups** from the profile link, when the user tracks them.
107
+
108
+ Likes alone are the weakest signal. Compare posts with each other, not with
109
+ other people's accounts.
110
+
111
+ ## 4. How often, and when
112
+
113
+ Starting points, not laws. The best cadence is the one the user can keep.
114
+
115
+ | Network | Suggested rhythm | Notes |
116
+ |---|---|---|
117
+ | X | At least 2 short posts a day, 5 days a week; to grow faster, 3 to 5 a day, 7 days a week, plus 2 or more threads or long posts a week. Text with an image or video does best. | Every post and thread entry counts toward the account's monthly X allowance in Postemi, so tell the user how many are left when the plan needs more. |
118
+ | LinkedIn | 1 post a day at most, 3 to 5 a week is plenty. | Posting more does not grow faster here. Mornings in the audience's timezone work well. Do not go weeks without posting. |
119
+ | Instagram | 3 to 5 feed posts or Reels a week, Stories in between. | Reels for reach, carousels for saves. |
120
+ | TikTok | Up to 1 or 2 a day. | Postemi allows about 15 posts per account in 24 hours. |
121
+ | Threads, Bluesky, Mastodon | 1 to 3 a day. | Conversation matters more than volume. |
122
+ | Facebook | 3 to 5 a week. | Local and community content. |
123
+ | YouTube | 1 a week; Shorts more often. | Consistency of the day helps viewers. |
124
+ | Blog channels | 1 to 4 a month. | The long versions of the best posts. |
125
+
126
+ Timing: start with morning and early evening in the audience's own timezone
127
+ (take the user's timezone from Postemi, and ask where the audience is), then
128
+ compare times in the log. `postemi posts:find-slot <id>` suggests the next
129
+ free slot on a channel's schedule.
130
+
131
+ ## 5. One topic, 30 posts
132
+
133
+ Once the user has a topic, turn it into a month of posts with the 30 angles
134
+ in [reference/30-angles.md](./reference/30-angles.md): tips, mistakes, tools,
135
+ steps, stories, lessons, myths, questions and more. Each angle becomes a
136
+ question, each answer becomes a post.
137
+
138
+ Mix the 30 across three to five **content buckets** (themes the audience
139
+ expects from the user, for example "how-to", "behind the scenes", "customer
140
+ results", "opinions") and refuse ideas that fit no bucket. That keeps the
141
+ account recognisable.
142
+
143
+ ### Turning the plan into a Postemi schedule
144
+
145
+ 1. Agree the network(s), the number of posts per week and the times.
146
+ 2. Write the first week in full (with `postemi-writing`), show it, adjust.
147
+ 3. Get the clock and timezone (`get_workspace_context`, or the CLI's saved
148
+ timezone), and spread the posts over the days at the agreed local times.
149
+ 4. Preview all of them in one `preview_post` call (one `socialPost` entry per
150
+ post), or show the list from the CLI; fix what the preview flags.
151
+ 5. On the user's yes, create them in one call with an `idempotencyKey`. Use
152
+ `type: "draft"` (CLI `-t draft`) if the user wants to review them in the
153
+ Postemi calendar before they go live.
154
+ 6. Repeat weekly, folding in what the numbers say. Writing a month ahead is
155
+ fine, but leave room for timely posts and for what you learn.
156
+
157
+ ## 6. Repurpose: one idea, every network
158
+
159
+ A post that worked is the best raw material for the next ones:
160
+
161
+ - **Across networks, adapted, not copied.** The same idea as an X short post,
162
+ an X thread, a LinkedIn long post with an image, an Instagram carousel, a
163
+ Threads post, and later a blog article. Each gets its own hook, length and
164
+ format (see `postemi-writing`). In Postemi each channel gets its own entry
165
+ with its own text in the same request.
166
+ - **Never the same post on two X accounts:** one X channel per post.
167
+ - **Up and down in size.** A thread becomes an article; an article becomes
168
+ five short posts; a popular reply or comment becomes its own post.
169
+ - **Again, later.** Re-share a winner after a few months with a new hook and
170
+ a fresh example; most followers did not see it the first time.
171
+ - **Collaborations.** Instagram posts can name collaborators (a setting in
172
+ Postemi); a post together with a partner brand or creator reaches both
173
+ audiences.
174
+
175
+ ## 7. Profile, bio and the path to a customer
176
+
177
+ Posts bring people to the profile; the profile decides whether they follow
178
+ and click. Help the user write it:
179
+
180
+ - **Bio:** "I help [who] [get what]" or "I write about [topic]", plus one line
181
+ of proof: "Baker for 12 years. 3 shops." Clear beats clever, as with hooks.
182
+ No list of ten roles.
183
+ - **One link,** to one next step: an e-mail list, a free guide or checklist,
184
+ a booking page, a product page. On X the bio is the place for links, since
185
+ Postemi removes links from X posts. On Instagram point to the link in the
186
+ bio. On LinkedIn, feature the free resource or product in the Featured
187
+ section.
188
+ - **Name and keywords:** put the topic word people search for in the display
189
+ name or headline (Instagram, LinkedIn) so the profile can be found.
190
+ - **The path:** post, profile, link, e-mail or sign-up, offer. Most posts just
191
+ give value; about one in five invites people to the next step (a free
192
+ resource, a waitlist, the product), with a clear reason to click. On
193
+ LinkedIn and Facebook that link can go in the first comment.
194
+ - **Pinned post:** the user's best post, or the one that explains what they do
195
+ and where to start.
196
+
197
+ ## 8. The user's part every day
198
+
199
+ Share this with the user plainly; Postemi cannot do it for them:
200
+
201
+ - Reply to every comment in the first hours after a post goes out; replies
202
+ bring more reach and turn readers into followers.
203
+ - Leave two or three thoughtful comments a day on posts by bigger accounts in
204
+ the same field. A good comment is a small post of its own, and a comment
205
+ that does well is an idea for a full post.
206
+ - Thank people who share.
207
+
208
+ ## 9. Review and iterate
209
+
210
+ Once a week (15 minutes), with the user:
211
+
212
+ 1. Pull the numbers for the week (section 3) into the log.
213
+ 2. Name the top three and the bottom three posts, and what they had in common
214
+ (topic, angle, hook pattern, format, time).
215
+ 3. Decide one bigger change for next week: more of the winning angle, a new
216
+ format, a different time, dropping a topic that never lands.
217
+ 4. Write and schedule next week with that change.
218
+
219
+ Once a month: is the main network working? Is the niche still the right
220
+ first one? Is the profile link getting clicks? Keep, adjust, or try the
221
+ second network. Details and a log template: [reference/review.md](./reference/review.md).
@@ -0,0 +1,74 @@
1
+ # One topic, 30 angles
2
+
3
+ Take one narrow topic and ask it 30 different questions. Each answer is a
4
+ post (often a list of three), so one topic fills a month. When the month is
5
+ done, take the same 30 angles with a narrower or neighbouring topic, or run
6
+ them again with new answers.
7
+
8
+ How to use it with the user:
9
+
10
+ 1. Agree the topic, narrow and with a reader in mind (see the idea builder in
11
+ `postemi-writing`): not "gardening" but "growing vegetables on a small
12
+ balcony for people new to it".
13
+ 2. Go through the angles, fill each question with the topic, and answer it
14
+ from the user's own experience or a named source. Skip angles the user has
15
+ nothing true to say about; never fill one with invented facts.
16
+ 3. Give each post a hook (`postemi-writing`, or a hook template from
17
+ `postemi-templates`) and a format (short post, thread, carousel, video).
18
+ 4. Spread them over the month and schedule them with Postemi
19
+ (`postemi-growth`, section 5).
20
+
21
+ Mark each angle in the post log, so the review shows which angles this
22
+ audience likes.
23
+
24
+ ## The 30 angles
25
+
26
+ | # | Angle | The question to answer |
27
+ |---|---|---|
28
+ | 1 | Tips | What are 3 tips for [topic]? |
29
+ | 2 | Skills | Which 3 skills matter most for [topic]? |
30
+ | 3 | Tools | What are the 3 best tools for [topic]? |
31
+ | 4 | Prompts | What are 3 AI prompts that help with [topic]? |
32
+ | 5 | Traits | What do people who are good at [topic] have in common? |
33
+ | 6 | Steps | What are the 3 key steps of [topic]? |
34
+ | 7 | Goals | What are 3 realistic first goals for [topic]? |
35
+ | 8 | Books | Which 3 books help most with [topic]? |
36
+ | 9 | Habits | Which 3 daily habits make [topic] easier? |
37
+ | 10 | Stories | What is a story (the user's own, or a sourced one) of [topic] going well? |
38
+ | 11 | Quotes | Which 3 sayings sum up [topic]? (with the real source) |
39
+ | 12 | Insider knowledge | What do experienced people know about [topic] that beginners do not? |
40
+ | 13 | Insights | What are 3 ideas that change how people see [topic]? |
41
+ | 14 | Benefits | What are the 3 biggest benefits of [topic]? |
42
+ | 15 | Lessons | What did failures in [topic] teach the user? |
43
+ | 16 | Reasons | Why does [topic] work? Give 3 reasons. |
44
+ | 17 | People | Which 3 people or accounts are worth following for [topic]? |
45
+ | 18 | Routines | What routine do people who do [topic] well follow? |
46
+ | 19 | Mistakes | What are the 3 most common mistakes in [topic]? |
47
+ | 20 | Podcasts and videos | Which 3 shows or channels are best on [topic]? |
48
+ | 21 | Examples | What are 3 good real examples of [topic]? |
49
+ | 22 | Questions | Which 3 questions should a beginner ask about [topic]? |
50
+ | 23 | What is new | What are 3 new tools, methods or changes in [topic]? |
51
+ | 24 | Frameworks | Which template or framework helps someone start [topic]? |
52
+ | 25 | Resources | What are the 3 best free resources for learning [topic]? |
53
+ | 26 | Obstacles | What are the 3 hardest parts of [topic], and how do people get past them? |
54
+ | 27 | Organisations | Which 3 companies or groups do [topic] well, and what can we learn? |
55
+ | 28 | Numbers | What are 3 telling facts or figures about [topic]? (sourced) |
56
+ | 29 | Starter kit | What are 3 things to buy or set up when starting [topic]? |
57
+ | 30 | Case study | What happened when someone (the user, a customer) did [topic] for a while? |
58
+
59
+ ## Worked example
60
+
61
+ Topic: growing vegetables on a small balcony, for people new to it.
62
+
63
+ | Day | Angle | Hook | Format |
64
+ |---|---|---|---|
65
+ | 1 | Mistakes | 3 balcony garden mistakes that kill seedlings in week one | short post |
66
+ | 2 | Tools | The only 4 tools you need for a balcony vegetable patch | carousel |
67
+ | 3 | Stories | Last spring I grew 9 kilos of tomatoes on a 2 square metre balcony. Here is the full story. | thread |
68
+ | 4 | Benefits | Why a balcony patch saves more than money | long post |
69
+ | 5 | Questions | What do you wish you had known before your first balcony garden? | question post |
70
+ | 6 | Steps | From empty balcony to first salad in 5 steps | how-to post |
71
+ | 7 | Starter kit | Your first balcony garden for under 50 euros | list post |
72
+
73
+ The other 23 angles fill the rest of the month. Post one or two a day on the
74
+ main network, and adapt the best ones for the second network.
@@ -0,0 +1,63 @@
1
+ # The post log and the weekly review
2
+
3
+ ## The post log
4
+
5
+ Keep one row per published post. A spreadsheet, a note or a Markdown table in
6
+ the user's project is enough; offer to keep it for the user if you can write
7
+ files. Fill the planning columns when the post is scheduled and the numbers a
8
+ few days after it goes out (LinkedIn posts can keep growing for days).
9
+
10
+ | Date | Network | Post id | Topic | Angle | Hook pattern | Format | Time | Impressions | Comments | Shares | Saves | Follows | Clicks |
11
+ |---|---|---|---|---|---|---|---|---|---|---|---|---|---|
12
+ | 2026-11-02 | LinkedIn | ... | pricing | Lessons | honest admission | long post + image | 08:30 | 1,840 | 14 | 3 | 9 | 6 | 11 |
13
+
14
+ - **Post id:** from `create_post`, `list_posts` or the CLI, so the numbers can
15
+ be matched later (`postemi analytics:post <post-id>`).
16
+ - **Angle:** how-to, analysis, inspiration, human nature, or one of the 30
17
+ angles.
18
+ - **Hook pattern:** which opener or pattern from `postemi-writing` or which
19
+ template from `postemi-templates`.
20
+ - Leave a number empty rather than guessing it.
21
+
22
+ ## Getting the numbers
23
+
24
+ - Postemi Insights in the web app, per channel and per period.
25
+ - CLI: `postemi analytics:post <post-id> -d 7` per post;
26
+ `postemi analytics:platform <integration-id> -d 30` per channel.
27
+ - MCP clients: ask the user for the numbers from Insights or the network's
28
+ own analytics (there is no analytics tool on MCP).
29
+
30
+ ## The weekly review (15 minutes)
31
+
32
+ 1. **Fill the log** for last week's posts.
33
+ 2. **Rank** by comments plus shares plus saves (or engagement rate when reach
34
+ differs a lot). Look at the top three and the bottom three.
35
+ 3. **Find the pattern.** What do the winners share: topic, angle, hook,
36
+ format, length, time, media? What do the losers share?
37
+ 4. **One decision.** Pick one bigger change for next week and write it down:
38
+ "two more posts on pricing lessons", "carousels instead of text on
39
+ LinkedIn", "move X posts to the evening". Change one main thing at a time,
40
+ so next week's numbers can show whether it helped.
41
+ 5. **Plan and schedule** next week with that change, in Postemi.
42
+ 6. **Reuse the winner:** schedule an adapted version of the best post on the
43
+ second network, or a follow-up post that goes deeper.
44
+
45
+ ## The monthly review
46
+
47
+ - Followers and reach per network over the month (Insights): growing, flat,
48
+ falling?
49
+ - The niche: which topic and angle won most weeks? Go deeper there.
50
+ - The profile link: are people clicking and signing up? If not, change the
51
+ offer or the bio before posting more.
52
+ - Cadence: could the user keep it? Lower it rather than skip weeks.
53
+ - Networks: keep the main one; add, keep or drop the second one.
54
+
55
+ ## Reading small numbers
56
+
57
+ - Compare posts with each other, not with other accounts.
58
+ - A post with two thoughtful comments beat a post with ten likes and no
59
+ comments.
60
+ - Wait for at least two or three posts of the same kind before calling a
61
+ pattern; one post can be luck.
62
+ - When everything is low, change something big (topic, format, network), not
63
+ a word in the hook.
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: postemi-templates
3
+ description: Postemi's library of ready post templates and hooks, the same ones the Postemi composer offers under Templates. Everyday posts, product launches, LinkedIn post types, X formats, conversation starters and more than 100 hooks (stories, contrarian takes, how-to, lists, books, habits, questions), each with [placeholders] to fill. Use when the user wants a quick draft of a common post type, a hook or opening line, a post idea for a goal (launch, engagement, teaching, story), or asks for templates.
4
+ ---
5
+
6
+ # Postemi templates and hooks
7
+
8
+ The templates in [reference/](./reference/index.md) are generated from the
9
+ Postemi app, so they match what the user sees in the composer's Templates
10
+ column. Each has a title, a line on when to use it, and a body with
11
+ [placeholders] in square brackets.
12
+
13
+ Pair with `postemi-writing` (how to make the filled template good) and the
14
+ main `postemi` skill (how to preview and schedule it).
15
+
16
+ ## Files
17
+
18
+ - [reference/index.md](./reference/index.md): every group and every template
19
+ in one table (id, title, network, when to use it). Read this first, then
20
+ open only the group file you need.
21
+ - Group files, with the full bodies:
22
+ - [everyday.md](./reference/everyday.md): launch, behind the scenes, tip,
23
+ roundup, customer story, event, question, milestone.
24
+ - [launch.md](./reference/launch.md): announcing and explaining what the
25
+ user builds.
26
+ - [linkedin.md](./reference/linkedin.md): 30 LinkedIn post types in six
27
+ sections (building in public, founder story, industry, team, teaching,
28
+ conversation).
29
+ - [x.md](./reference/x.md): short X formats.
30
+ - Hooks, by what the post does:
31
+ [hook-stories.md](./reference/hook-stories.md) (lessons and stories),
32
+ [hook-contrarian.md](./reference/hook-contrarian.md) (contrarian takes),
33
+ [hook-how-to.md](./reference/hook-how-to.md) (frameworks and how-to),
34
+ [hook-lists.md](./reference/hook-lists.md) (lists and tools),
35
+ [hook-learning.md](./reference/hook-learning.md) (books and learning),
36
+ [hook-growth.md](./reference/hook-growth.md) (habits and growth),
37
+ [hook-talk.md](./reference/hook-talk.md) (problems and questions).
38
+ - [engagement.md](./reference/engagement.md): questions, polls and prompts
39
+ that get replies.
40
+
41
+ ## Pick a template
42
+
43
+ Start from the user's goal, then the network:
44
+
45
+ | Goal | Look in |
46
+ |---|---|
47
+ | Announce a product, feature or event | `launch.md`, `everyday.md` (`launch`, `eventReminder`) |
48
+ | Build trust as a founder or expert | `linkedin.md` (founder story, building in public), `hook-stories.md` |
49
+ | Teach something useful | `hook-how-to.md`, `everyday.md` (`quickTip`), `linkedin.md` (teach) |
50
+ | Start a debate, stand out | `hook-contrarian.md`, `linkedin.md` (`liHotTake`), `x.md` |
51
+ | Get comments and replies | `engagement.md`, `hook-talk.md` |
52
+ | Share tools, books, resources | `hook-lists.md`, `hook-learning.md` |
53
+ | Motivate, habits, personal growth | `hook-growth.md` |
54
+ | Show the team and culture | `linkedin.md` (team), `everyday.md` (`behindScenes`) |
55
+ | Social proof | `everyday.md` (`customerStory`, `milestone`) |
56
+
57
+ Network fit:
58
+
59
+ - Ids starting with `li` were written for LinkedIn and ids starting with `x`
60
+ for X; the index says so in its Network column. The rest fit anywhere.
61
+ - A LinkedIn template on X: shorten it to the hook and one or two lines, or
62
+ turn it into a thread (one point per entry). Check the account's limit.
63
+ - An X template on LinkedIn: add the context and a story; the hook must sit
64
+ in the first two or three lines.
65
+ - For Instagram, TikTok and YouTube the template becomes the caption; the
66
+ picture or video still carries the post.
67
+ - Remove any link from text going to X (Postemi strips links from X posts).
68
+
69
+ Offer two or three templates that fit and let the user choose, or pick one
70
+ and say why in a sentence.
71
+
72
+ ## Fill it in
73
+
74
+ 1. Ask the user for what the placeholders need, in one short message: the
75
+ facts, the numbers, the story. Never invent them. A template with made-up
76
+ details is worse than no post.
77
+ 2. Replace every `[placeholder]`. Remove a line whose placeholder the user
78
+ cannot fill, rather than leaving it vague.
79
+ 3. Number placeholders (`[number]`) must be true numbers, and a list must
80
+ have as many items as its hook promises.
81
+ 4. Rewrite in the user's voice. The template is a skeleton, not a script:
82
+ change words, order and length freely. Keep the shape that makes it work
83
+ (the hook, the turn, the takeaway).
84
+ 5. Hooks are openings: a hook template gives the first lines; write the rest
85
+ with `postemi-writing` (keep the promise of the hook, lead with the best
86
+ part, end with one takeaway or question).
87
+ 6. Run the check in `postemi-writing` (section 7), then preview and schedule
88
+ with the main `postemi` skill.
89
+
90
+ ## Example
91
+
92
+ User: "I want to post on LinkedIn that we finally shipped dark mode."
93
+
94
+ 1. Goal: announce a feature; network: LinkedIn. Candidates: `liFeature`,
95
+ `liBuiltWrong` (if customer feedback changed the plan).
96
+ 2. `liFeature` body: "We just shipped [feature]. It took us [time], longer than
97
+ we planned. The reason: [...]".
98
+ 3. Ask: how long did it take, what was harder than expected, what can people
99
+ do now, one lesson.
100
+ 4. Fill, rewrite in the user's voice, check, `preview_post` (or show the text
101
+ in the CLI flow), schedule on the user's yes.
102
+
103
+ ## Keeping this in sync
104
+
105
+ These files are generated. In the agent repository:
106
+ `pnpm sync:templates <path to the app's templates folder>`, then
107
+ `pnpm sync:skills`, then commit. Do not edit the reference files by hand.
@@ -0,0 +1,155 @@
1
+ <!-- Generated by scripts/sync-templates.mjs from the Postemi app's template library (en.ts, catalog.ts). Do not edit by hand: change the app, then run the script again. -->
2
+
3
+ # Conversation starters
4
+
5
+ Questions, polls and prompts that get people to reply.
6
+
7
+ 11 templates. Square brackets are placeholders: replace every one before you post.
8
+
9
+ ## Question for your audience (`question`)
10
+
11
+ - Network: any network
12
+ - Use it when: Start a conversation and hear what people think.
13
+
14
+ ```text
15
+ We would love your view: [your question]?
16
+
17
+ A) [first option]
18
+ B) [second option]
19
+
20
+ Reply with A or B, or tell us what we missed. We read every answer.
21
+ ```
22
+
23
+ ## Ask a question (`liQuestion`)
24
+
25
+ - Network: LinkedIn
26
+ - Use it when: Simple, as long as you ask something people want to answer.
27
+
28
+ ```text
29
+ [audience]: what is one [tool, habit or idea] you could not work without?
30
+
31
+ Mine: [your answer].
32
+ ```
33
+
34
+ ## Ask for hot takes (`liOpinionPrompt`)
35
+
36
+ - Network: LinkedIn
37
+ - Use it when: Invite others to share their unpopular opinions, and go first.
38
+
39
+ ```text
40
+ What is an unpopular opinion you hold about [topic]?
41
+
42
+ I will go first: [your take].
43
+ ```
44
+
45
+ ## A poll (`liPoll`)
46
+
47
+ - Network: LinkedIn
48
+ - Use it when: Polls make it easy to take part. Use them now and then, not every week.
49
+
50
+ ```text
51
+ What matters more for [audience or stage]?
52
+
53
+ • [option A]
54
+ • [option B]
55
+
56
+ Vote, then tell me why in the comments.
57
+ ```
58
+
59
+ ## What would you do? (`liScenario`)
60
+
61
+ - Network: LinkedIn
62
+ - Use it when: Share a real dilemma and let people weigh in.
63
+
64
+ ```text
65
+ Scenario: [the situation you faced].
66
+
67
+ What would you do?
68
+
69
+ I will share what we did in the comments tomorrow.
70
+ ```
71
+
72
+ ## Say thank you (`liThanks`)
73
+
74
+ - Network: LinkedIn
75
+ - Use it when: Thank someone who helped. They reply, and their network sees it.
76
+
77
+ ```text
78
+ A thank you to [person] for [what they did].
79
+
80
+ It helped more than they know: [the difference it made].
81
+ ```
82
+
83
+ ## Quick vote (`xPoll`)
84
+
85
+ - Network: X
86
+ - Use it when: Easy to join, and you learn what your audience thinks.
87
+
88
+ ```text
89
+ Quick question for [audience]:
90
+
91
+ [your question]
92
+
93
+ A) [option]
94
+ B) [option]
95
+ C) [option]
96
+
97
+ Reply with a letter.
98
+ ```
99
+
100
+ ## Describe it in one word (`xOneWord`)
101
+
102
+ - Network: X
103
+ - Use it when: An easy ask that gets a lot of replies. Good for reach, less so for authority.
104
+
105
+ ```text
106
+ Describe [thing] in one word.
107
+
108
+ I will start: [your word].
109
+ ```
110
+
111
+ ## Best examples, add yours (`hExamples`)
112
+
113
+ - Network: any network
114
+ - Use it when: Share your favourites and ask people to add more.
115
+
116
+ ```text
117
+ The best examples of [topic] I have seen:
118
+
119
+ • [example]
120
+ • [example]
121
+ • [example]
122
+
123
+ What would you add?
124
+ ```
125
+
126
+ ## Questions that are hard to answer (`hHardQuestions`)
127
+
128
+ - Network: any network
129
+ - Use it when: Ask the questions your audience struggles with.
130
+
131
+ ```text
132
+ [number] questions every [role] struggles to answer:
133
+
134
+ 1. [question]
135
+ 2. [question]
136
+ 3. [question]
137
+
138
+ Which one is hardest for you?
139
+ ```
140
+
141
+ ## Which problem is yours? (`hFourProblems`)
142
+
143
+ - Network: any network
144
+ - Use it when: Sort your audience's problems so each person finds theirs.
145
+
146
+ ```text
147
+ Most [audience] struggle with one of these:
148
+
149
+ 1. They do not [problem]
150
+ 2. They do not [problem]
151
+ 3. They cannot [problem]
152
+ 4. They have no [problem]
153
+
154
+ Which one is yours?
155
+ ```