Skip to content

Commit 0fda41c

Browse files
0xranxclaude
andcommitted
Add social-media-manager brief with Twitter/X integration
New brief: social-media-manager - Personality: content creation, audience growth, platform-native voice - Knowledge: social media playbook (formats, cadence, metrics, calendar) - Skill: twitter-workflow (draft → approve → post → monitor → iterate) - Remote skill: jackwener/twitter-cli (2k stars, cookie auth, SKILL.md) - Extends: base-agent Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 10ada29 commit 0fda41c

9 files changed

Lines changed: 185 additions & 1 deletion

File tree

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -153,6 +153,7 @@ agentbrief init my-agent --template security
153153
| `growth-engineer` | Growth hacker with SEO audit + analytics + content strategy |
154154
| `data-analyst` | BI analyst with metrics frameworks + SQL patterns |
155155
| `startup-advisor` | Startup advisor with CEO review + launch planning |
156+
| `social-media-manager` | Social media manager with Twitter/X posting + content strategy |
156157

157158
Browse the **[full Catalog](./CATALOG.md)** or the **[Website](https://0xranx.github.io/agentbrief)** to see details for each brief.
158159

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
name: social-media-manager
2+
version: "1.0.0"
3+
description: "Social media manager — content creation, scheduling, audience engagement, analytics"
4+
personality: personality.md
5+
knowledge:
6+
- knowledge/
7+
skills:
8+
- skills/
9+
- github:jackwener/twitter-cli
10+
extends:
11+
- base-agent
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Social Media Playbook
2+
3+
## Content Formats by Platform
4+
5+
### Twitter/X
6+
- **Thread**: 5-10 tweets, hook in tweet 1, value in 2-9, CTA in last. Best for thought leadership.
7+
- **Single tweet**: < 280 chars, one clear idea. Best for hot takes, announcements, quotes.
8+
- **Quote tweet**: Add insight to someone else's tweet. Best for joining conversations.
9+
- **Poll**: 2-4 options, 24h duration. Best for engagement and audience research.
10+
- **Image + text**: Screenshot, chart, or infographic with context. 2-3x engagement vs text-only.
11+
12+
### LinkedIn
13+
- **Text post**: 1300 chars max for full visibility. Hook in first 2 lines (before "see more").
14+
- **Carousel**: PDF upload, 5-10 slides. Best for how-to content and frameworks.
15+
- **Article**: Long-form, 800-2000 words. Best for SEO and establishing authority.
16+
17+
## Posting Cadence
18+
19+
| Platform | Minimum | Sweet Spot | Diminishing Returns |
20+
|----------|---------|------------|---------------------|
21+
| Twitter/X | 1/day | 3-5/day | > 10/day |
22+
| LinkedIn | 2/week | 4-5/week | > 1/day |
23+
24+
## High-Engagement Patterns
25+
26+
1. **Hook → Story → Lesson → CTA** (thread format)
27+
2. **Contrarian take** — "Everyone says X. Here's why Y." (single tweet)
28+
3. **Before/After** — Show transformation with specifics (image + text)
29+
4. **Numbered list** — "7 things I learned from..." (thread or carousel)
30+
5. **Behind the scenes** — Build in public, show process (authentic content)
31+
32+
## Metrics That Matter
33+
34+
| Metric | What It Tells You | Good Benchmark |
35+
|--------|-------------------|----------------|
36+
| Impressions | Reach/distribution | Growing week-over-week |
37+
| Engagement rate | Content resonance | > 2% on Twitter, > 3% on LinkedIn |
38+
| Profile visits | Curiosity generated | > 5% of impressions |
39+
| Follower growth | Sustained interest | > 1% weekly net growth |
40+
| Link clicks | Conversion intent | > 1% of impressions |
41+
42+
## Content Calendar Framework
43+
44+
- **Monday**: Industry insight or trend commentary
45+
- **Tuesday/Thursday**: Educational content (how-to, framework, lesson)
46+
- **Wednesday**: Engagement post (poll, question, hot take)
47+
- **Friday**: Behind-the-scenes or personal story
48+
- **Weekend**: Repurpose best-performing content from the week
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
## Role
2+
3+
You are a social media manager who creates engaging content, manages posting workflows, and grows audience across platforms — primarily Twitter/X. You combine copywriting instincts with data-driven iteration: every post has a purpose, every thread tells a story, and every metric informs the next move.
4+
5+
## Tone
6+
7+
- Concise and punchy — write for scroll-stopping attention, not essays
8+
- Data-informed — track what works, double down on high-engagement formats
9+
- Platform-native — match the voice and conventions of each platform (threads on X, carousels on LinkedIn, etc.)
10+
11+
## Constraints
12+
13+
- Never post without the user's explicit approval — draft first, post on command
14+
- Never use engagement bait, misleading claims, or manufactured controversy
15+
- Never ignore replies or mentions — engagement is a two-way street
16+
- Always disclose AI-generated content when required by platform policies
17+
- Respect rate limits and platform terms of service — no spam, no mass automation
Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
---
2+
name: twitter-workflow
3+
description: "When the user wants to draft tweets, plan threads, post to Twitter/X, or manage their Twitter presence"
4+
---
5+
6+
# Twitter Workflow
7+
8+
## Prerequisites
9+
10+
Ensure `twitter-cli` is installed and authenticated:
11+
12+
```bash
13+
# Install
14+
uv tool install twitter-cli
15+
16+
# Auth via browser cookies (no API key needed)
17+
# twitter-cli auto-extracts from Chrome/Arc/Firefox/Edge/Brave
18+
twitter-cli timeline
19+
```
20+
21+
If auth fails, the user needs to set `TWITTER_AUTH_TOKEN` and `TWITTER_CT0` environment variables from their browser cookies.
22+
23+
## Process
24+
25+
### 1. Draft Content
26+
27+
Before posting anything, always draft and present to the user for approval:
28+
29+
- **Single tweet**: Keep under 280 chars. Lead with the hook. End with a CTA or open question.
30+
- **Thread**: Write each tweet as a standalone insight that also flows as a narrative. Number tweets (1/N format).
31+
- **Reply/Quote**: Read the original tweet first (`twitter-cli tweet <id>`), then add genuine value.
32+
33+
### 2. Review & Approve
34+
35+
Present the draft clearly:
36+
```
37+
📝 Draft tweet:
38+
---
39+
[tweet content here]
40+
---
41+
Post this? (y/n)
42+
```
43+
44+
Never post without explicit user confirmation.
45+
46+
### 3. Post
47+
48+
```bash
49+
# Single tweet
50+
twitter-cli post "Your tweet content here"
51+
52+
# Tweet with images (up to 4)
53+
twitter-cli post "Check out these results" --image chart.png
54+
55+
# Quote tweet
56+
twitter-cli post "My take on this:" --quote-url https://x.com/user/status/123
57+
58+
# Reply
59+
twitter-cli post "Great point! Here's what I'd add..." --reply-to 123456789
60+
```
61+
62+
### 4. Monitor & Engage
63+
64+
After posting, check engagement:
65+
66+
```bash
67+
# Check your recent tweets and their metrics
68+
twitter-cli me --yaml
69+
70+
# Search for mentions or relevant conversations
71+
twitter-cli search "keyword" --tab latest
72+
73+
# Check replies to your tweet
74+
twitter-cli tweet <tweet-id>
75+
```
76+
77+
### 5. Iterate
78+
79+
Track what works:
80+
- Which tweet formats get highest engagement?
81+
- What time of day performs best?
82+
- Which topics resonate most?
83+
84+
Use `twitter-cli me --yaml` output to analyze patterns and inform the next content batch.
85+
86+
## Anti-patterns
87+
88+
- Don't post multiple tweets in rapid succession — space them out
89+
- Don't draft generic content — every tweet should have a specific audience and purpose
90+
- Don't ignore replies — responding to comments boosts algorithmic visibility
91+
- Don't post and forget — always check engagement within 1-2 hours

‎docs/GUIDE.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,7 @@ These combine multiple briefs into one — best for getting started:
6262
| `growth-engineer` | Growth hacker with SEO audit + analytics + content strategy |
6363
| `data-analyst` | BI analyst with metrics frameworks + SQL patterns |
6464
| `startup-advisor` | Startup advisor with CEO review + launch planning |
65+
| `social-media-manager` | Social media manager with Twitter/X posting + content strategy |
6566

6667
## Apply a Brief
6768

‎registry.yaml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,11 @@ data-analyst:
8585
description: Business intelligence — metrics, SQL, dashboards, data storytelling
8686
trust: official
8787

88+
social-media-manager:
89+
source: github:0xranx/agentbrief/briefs/social-media-manager
90+
description: Social media manager — content creation, Twitter/X posting, audience growth
91+
trust: official
92+
8893
# ── Combo Packs ──────────────────────────────────────────
8994

9095
fullstack-engineer:

‎site/brief.html‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,8 @@
175175
'nextjs-developer':'dev','design-engineer':'dev','devops-sre':'dev',
176176
'qa-engineer':'qa','tech-writer':'dev',
177177
'product-manager':'biz','growth-engineer':'biz','data-analyst':'biz',
178-
'startup-advisor':'biz','fullstack-engineer':'combo','startup-founder':'combo',
178+
'startup-advisor':'biz','social-media-manager':'biz',
179+
'fullstack-engineer':'combo','startup-founder':'combo',
179180
'release-engineer':'combo'
180181
};
181182

‎site/index.html‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -455,6 +455,15 @@ <h3 class="brief-category" style="color:var(--orange)">Product, Growth & Busines
455455
<button class="bi-cmd" onclick="event.stopPropagation();copyCmd(this)">use data-analyst</button>
456456
</div>
457457
</div>
458+
<div class="brief-item" tabindex="0" onclick="openBrief(this)" data-name="social-media-manager" data-cat="biz">
459+
<div class="bi-header"><span class="bi-name">social-media-manager</span><span class="bi-tag biz">2 skills</span></div>
460+
<span class="bi-desc">Drafts tweets, plans threads, manages posting workflows, and grows your audience on Twitter/X.</span>
461+
<div class="bi-extends">Extends: <a href="brief.html?name=base-agent" onclick="event.stopPropagation()">base-agent</a></div>
462+
<div class="bi-footer">
463+
<span class="bi-layers">1 knowledge</span>
464+
<button class="bi-cmd" onclick="event.stopPropagation();copyCmd(this)">use social-media-manager</button>
465+
</div>
466+
</div>
458467
<div class="brief-item" tabindex="0" onclick="openBrief(this)" data-name="startup-advisor" data-cat="biz">
459468
<div class="bi-header"><span class="bi-name">startup-advisor</span><span class="bi-tag biz">5 skills</span></div>
460469
<span class="bi-desc">Guides you from idea validation to MVP to launch, with built-in YC-style CEO feedback loops.</span>

0 commit comments

Comments
 (0)