Generates a weekly TikTok content brief for Darrell by scanning Git activity and writing 3 ranked video angles to the vault. Use this skill every Sunday evening, or whenever Darrell asks for content ideas, video topics, what to record this week, or what to talk about on TikTok.
Encoded preference skill. Removes pre-production friction for off-the-cuff talking head videos. Scans what actually happened this week, then produces 3 ready-to-record video angles in Darrell's voice.
Output: ~/Documents/DT Vault/1-projects/tiktok/briefs/YYYY-MM-DD.md
Supporting files:
Run the scan script and collect output:
!bash ~/.claude/skills/weekly-content-brief/scripts/scan-git.sh
Returns commit messages from the last 7 days across all active repos. Skip repos with no commits silently.
Read the pain bank for audience-sourced content signals: ~/Documents/DT Vault/1-projects/tiktok/pain-bank.md
If the pain bank exists, it contains real pain signals harvested from Reddit, classified by TAYA Big 5 categories (Cost/Price, Problems/Negatives, Versus/Comparisons, Reviews, Best-of Lists). Each entry has a recurrence count — higher recurrence means more people independently expressed the same pain. Prioritize entries with recurrence >= 2 as angle candidates. Aim for Big 5 category diversity across the 3 angles (not all from the same category).
Read the content flywheel to avoid duplicating already-posted seeds: ~/Documents/DT Vault/1-projects/content-flywheel.md
List ~/Documents/DT Vault/1-projects/tiktok/briefs/ to see angles from the last 3 briefs. Don't repeat an angle already suggested recently.
Load references/voice-rules.md before writing any hooks or talking points.
Mid-level engineers (dev or ops background) trying to break into DevOps/SRE roles. They see tools on job postings and want to understand them well enough for interviews and on the job. They're motivated by career progression — getting hired, getting promoted, getting paid more. They don't need to be talked down to. They need the mental model that connects what they know to what they don't.
Git activity is EVIDENCE, not the angle. The angle comes from the audience's pain point.
BAD: "I rewrote 7 community posts" (work report — audience doesn't care about your workflow) GOOD: "You're reading docs for tools you'll never use on the job" (audience pain → your rewrite is the proof)
BAD: "My homelab broke at 2 AM" (cool story about you) GOOD: "What happens when prod goes down and you're 8,000 miles away?" (career fear → your homelab story is the illustration)
For each angle, ask: "What is the viewer getting from this?" If the answer is "insight into Darrell's week," rewrite it. If the answer is "a mental model, career strategy, or emotional permission they needed," ship it.
Pain signals are the audience's actual words — use them to find the angle, then connect to git activity for evidence.
The pain bank entry's raw quotes are hook material. The recurrence count tells you how widespread the pain is. The Big 5 category tells you what type of content to make.
BAD: Pick a pain signal and give generic advice (that's what every other creator does) GOOD: Pick a pain signal, find where your git activity THIS WEEK proves you have a real answer, and build the angle from that intersection
If a high-recurrence pain signal doesn't connect to this week's git activity, save it — it'll connect eventually. Don't force it.
Hook: [First 1-2 sentences on camera. Starts with THEIR pain, fear, or question — not your activity. Mid-story or direct question. Creates "wait, what?" reaction.]
Talk about:
Evidence: [Which git activity or real work makes this authentic this week]
Flywheel: [Skool signup / consulting credibility / community discussion]
After the 3 angles, append:
Audit trail so Darrell can see what fed the brief.
Create directory if missing: mkdir -p ~/Documents/DT\ Vault/1-projects/tiktok/briefs/
Write to: ~/Documents/DT Vault/1-projects/tiktok/briefs/YYYY-MM-DD.md Use today's date for filename. See examples/sample-brief.md for full file format.
After writing the brief, run the ingest workflow:
qmd search "main angle topics" --json -n 5 to find related vault pages. Add [[briefs/YYYY-MM-DD]] backlinks to the 2-3 most relevant pages (e.g., related client work, field guides, origin stories).~/Documents/DT Vault/log.md:
## [YYYY-MM-DD] ingest | Content Brief — <top angle one-liner>qmd update && qmd embed to update the search index.Print to stdout: Brief written to ~/Documents/DT Vault/1-projects/tiktok/briefs/YYYY-MM-DD.md Angles: 1. [one-liner] 2. [one-liner] 3. [one-liner]
No interactive prompts. Runs autonomously. Cron: 0 19 * * 0 (Sundays 7pm) Register: "Schedule weekly-content-brief every Sunday at 7pm, read-only execution."