Phy Content Compound

Cleanup Review

python scripts/_cleanup.py is an optional cleanup helper for the phy-content-compound — Content Atom Library Builder skill. It may recursively remove /tmp/_skill_work, /tmp/skill_scratch. Show the exact paths first, explain whether they are skill-private temporary paths or user state, and run the cleanup only after the user confirms.

phy-content-compound — Content Atom Library Builder

77% of social media creators report burnout. The #1 cause: starting from a blank page every time. You've already written the best version of your ideas — in past posts, comments, threads. The problem is you can't find and recombine them.

This tool scans your past content, extracts reusable "content atoms," and retrieves the most relevant ones when you need to write about a new topic. Every post you write makes the next one easier.

Quick Start

# Build atom library from your content directory
python3 ~/.claude/skills/phy-content-compound/scripts/content_compound.py ~/Desktop/content-ideas/

# Build library + query for a topic
python3 ~/.claude/skills/phy-content-compound/scripts/content_compound.py ~/posts/ --topic "developer tools"

# Query specific atom type
python3 ~/.claude/skills/phy-content-compound/scripts/content_compound.py ~/posts/ --topic "AI" --type data_point

# Get top 10 results
python3 ~/.claude/skills/phy-content-compound/scripts/content_compound.py ~/posts/ --topic "security" --top 10

# JSON output
python3 ~/.claude/skills/phy-content-compound/scripts/content_compound.py ~/posts/ --topic "growth" --format json

The 6 Atom Types

How It Works

Your content files (.md, .txt)
    ↓
[Extract atoms] — regex-based sentence classification
    ↓
[Tag keywords] — context-window keyword extraction
    ↓
[Build library] — 6 atom types, source attribution, line numbers
    ↓
[Query topic] — keyword overlap scoring + text presence matching
    ↓
[Generate outline] — Hook (contrarian/data) → Body (claims+data+proof) → CTA (question)

Example Output

==================================================================
  phy-content-compound — Content Atom Library
==================================================================
  Files scanned  : 14
  Total atoms    : 591
==================================================================

📊  Atoms by Type:

  📊 data_point      485 atoms
  🔧 framework        90 atoms
  ❓ question           7 atoms
  📖 anecdote           4 atoms
  💡 claim              3 atoms
  🔥 contrarian         2 atoms

🔍  Top atoms for: "developer tools security"

  1. 📊 [data_point] (relevance: 5.0)
     "55 automated audit checks, maps to OWASP Agentic Top 10"
     — Source: skills-marketplace-guide.md:112

  2. 📖 [anecdote] (relevance: 3.5)
     "I spent a week mapping every platform, scanning for security"
     — Source: skills-marketplace-guide.md:7

📝  Suggested Outline for: "developer tools security"

  1. HOOK: Lead with data (55 automated audit checks...)
  2. BODY: Core argument + supporting data + personal proof
  3. CTA: Close with a genuine question

The Compounding Effect

Based on Zettelkasten research: the "serendipity effect" kicks in at 50-100 well-connected notes.

Content Pipeline Integration

This tool is the final piece of the social media flywheel:

COMPOUND (find your best past atoms)
    → Write draft
    → HUMANIZER (remove AI signals)
    → RULES ENGINE (pre-flight platform check)
    → Post
    → FORENSICS (analyze what worked)
    → feedback into COMPOUND (grows your atom library)

Each cycle makes the next one better. The library grows, retrieval improves, writing gets faster.

Research Basis

Technical Notes

• Zero external dependencies — pure Python 3.7+ stdlib
• Supported file types: .md, .txt (recursive scan)
• Skips: .git/, node_modules/, __pycache__/, venv/
• Keyword extraction: Context-window TF approach (no external NLP library)
• Scoring: Keyword overlap × 2 + text presence × 1.5 + engagement bonus
• Engagement hints: Inferred from filename patterns (e.g., "viral", "top", "hit")

Companion Skills