`README.md`

65 lines
# tiktok-architect

A Claude Code **skill** (its own git repo, symlinked into `~/.claude/skills/`)
that scouts the **Claude Code / vibecoding tips and anti-patterns** posted by
the TikTok creator **@tiktok_architect** (e.g. *"Never ask Claude code to do
this!"*), **verifies each claim** against how Claude Code actually works, dedupes
against Steve's existing rules, scores it, and drafts **gated** memos to codify
the good ones into MEMORY.md / CLAUDE.md. Retrieval and scoring run freely;
changing Steve's standing instructions is his call.

## Why it exists

@tiktok_architect's Claude content is a stream of short "never do X / always do
Y / here's a trick" tips. That's a real signal — but short-form tips are
engagement-optimized and often **outdated, model-version-stale, or wrong**. This
skill is the **rule-scout** counterpart to `gurisingh-scout` (the tool-scout):
where that one adopts open-source repos, this one adopts *behavioral rules*, so
its first gate is **truth**, not stars. It turns the feed into adopt / watch /
skip decisions instead of hype.

## The two hard parts

1. **Retrieval** — TikTok video pages are JS-rendered (HTML = the "Make Your
   Day" shell) and there's no transcript API. The skill uses the no-JS
   primitives: the oEmbed endpoint for a single link, yt-dlp's flat playlist for
   a "what's new" sweep, and local-whisper on the audio only when the caption
   isn't enough.
2. **The mixed feed** — the creator also posts motorcycles, hobbies, and privacy
   takes. Every scan filters to `claude_relevant` videos by hashtag/keyword.

## Layout

- `SKILL.md` — the procedure Claude runs (retrieve → filter → extract → VERIFY →
  dedupe → score → deliver gated codify-shortlist).
- `scripts/tt-oembed.js` — one TikTok URL (incl. `/t/` short link) → caption +
  hashtags + author + `claude_relevant`. No JS, no auth, `$0`.
- `scripts/tt-list.js` — a creator's newest N videos, each `claude_relevant`-
  flagged, via yt-dlp. `$0`.
- `scripts/tt-transcript.sh` — a tip's spoken text: yt-dlp subs → local whisper
  → honest fallback. `$0`, optional.
- `scripts/gh-repo-stats.js` — GitHub repo → stars/license/freshness, for tips
  that name a tool. Honors `GITHUB_TOKEN`.
- `references/sources.md` — the anchor handle, the mixed-feed filter, the
  verify-the-claim principle, similar creators.
- `references/retrieval-playbook.md` — the JS-wall-resistant retrieval order.
- `references/adoption-rubric.md` — the correctness gate, six-dimension scoring,
  dedupe, gating, output shape.

## Quick checks

```bash
node scripts/tt-oembed.js "https://www.tiktok.com/@tiktok_architect/video/<id>"
node scripts/tt-list.js tiktok_architect 12
bash scripts/tt-transcript.sh "https://www.tiktok.com/@tiktok_architect/video/<id>"
```

## Invoke

`/tiktok-architect` — or "tiktok architect", "what's tiktok_architect posting",
"any new Claude Code tips worth adopting", or drop a `@tiktok_architect` link.

> Note: the skill is named `tiktok-architect` (hyphen) to satisfy the
> hyphen-case skill-naming rule; the creator's handle keeps its underscore
> (`@tiktok_architect`).