adding-tweets

Add tweets with author linking, tags, and personal annotations.

Expected Input

User provides:

1. Tweet URL - x.com/*/status/* or twitter.com/*/status/*
2. Pasted tweet content - Copy-pasted from Twitter/X

Example user input:

add this tweet https://x.com/naval/status/1234567890

my favorite way to use Claude Code is spec based

start with a minimal spec and ask Claude to interview you

Workflow

Phase 1: Parse URL → Extract tweet ID and author handle
Phase 2: Parse Content → Extract text, date, author name from paste
Phase 3: Author Resolution → Check/create author profile
Phase 4: Generate Tweet File → Write to content/tweets/
Phase 5: Suggest Editing → Tags, annotations, wiki-links
Phase 6: Quality Check → Run vp check && pnpm typecheck

Phase 1: Parse URL

Extract from URL using regex:

• tweetId: The numeric ID from /status/{id}
• authorHandle: The username from x.com/{username}/status/

Pattern: (?:x\.com|twitter\.com)/([^/]+)/status/(\d+)
Example: https://x.com/naval/status/1789234567890
         → authorHandle: "naval"
         → tweetId: "1789234567890"

Phase 2: Parse Content

From the pasted text:

• tweetText: The main tweet content (clean up any extra whitespace)
• tweetedAt: If date is visible in paste, use it. Otherwise use today's date.
• authorName: If visible (e.g., "Naval Ravikant"), use it. Otherwise use handle.

If critical info is missing, use the AskUserQuestion tool to gather it:

question: "I need some missing tweet info. What is the tweet text?"
header: "Tweet Info"
multiSelect: false
options:
  - label: "I'll provide it"
    description: "Let me paste the tweet content"

For optional fields like date, ask separately if needed.

Phase 3: Author Resolution

1. Check if author exists:

   ls content/authors/{authorHandle}.md
   

2. If not exists, create minimal profile:

   ---
   name: "{Display Name or Handle}"
   slug: { authorHandle }
   socials:
     twitter: "https://x.com/{authorHandle}"
   ---
   

3. For full author enhancement, suggest running /enhance-author {authorHandle}

Phase 4: Generate Tweet File

Slug format: tweet-{tweetId}

File path: content/tweets/tweet-{tweetId}.md

Frontmatter template:

---
type: tweet
title: "{First 50 chars of tweet}..."
tweetId: "{tweetId}"
tweetUrl: "{originalUrl}"
tweetText: "{full tweet text}"
author: { authorHandle }
tweetedAt: { YYYY-MM-DD }
tags:
  - { suggested tags }
---
{ User's personal annotations go here }

Phase 5: User Editing

After saving, inform user:

• File location
• Suggest adding tags (use .claude/skills/adding-notes/scripts/list-existing-tags.sh for suggestions)
• Suggest adding personal annotations in the body
• Suggest wiki-links to related notes

Tag Suggestions

Based on tweet content, suggest from existing tags:

.claude/skills/adding-notes/scripts/list-existing-tags.sh

Common tweet themes → tags:

• Wisdom, advice → mindset, philosophy
• Business, startups → startup, business
• Technology → tech, programming
• Productivity → productivity, habit
• AI, Claude → claude-code, ai-agents, prompt-engineering

Validation

Before saving, verify:

1. Tweet ID is unique (no duplicate file exists)
2. Author profile exists or was created
3. tweetedAt is valid date format
4. tweetText is not empty

---

Phase 6: Quality Check

Run linter and type check to catch any issues:

vp check && pnpm typecheck

If errors are found, fix them before completing the task.