`README.md`

47 lines
# gurisingh-scout

A Claude Code **skill** (its own git repo, symlinked into `~/.claude/skills/`)
that scouts newly open-sourced Claude Code skills / subagents / MCP servers /
AI-agent tools surfaced by **Guri Singh** (`@heygurisingh` on X, `gurisaroy` on
LinkedIn) and similar educators — then evaluates each for adoption into Steve's
stack: dedupe against existing skills, score fit/leverage/trust, draft **gated**
install memos. Discovery and scoring run freely; installing anything is Steve's
call.

## Why it exists

Guri Singh's whole genre is *"someone just open-sourced X for Claude Code — it's
called Y, here's how it works ↓"* (past picks: `codeburn`, `career-ops`,
`gstack`, `claude-code-best-practice`, "Understand Anything", `Graphify`,
`Caveman`). That's a high-signal adoption feed — this skill harvests it into
adopt/watch/skip decisions instead of hype.

The hard part is **retrieval**: `x.com` 402s unauthenticated reads and the
account is intermittently suspended, so the skill fans out across mirrors
(Exa-indexed Thread Reader + LinkedIn `gurisaroy`, WebSearch) and only uses
direct-X hydration when the account is live.

## Layout

- `SKILL.md` — the procedure Claude runs (retrieve → extract → enrich → dedupe →
  score → deliver gated shortlist).
- `scripts/hydrate-tweet.js` — one X post → verbatim text + GitHub links, no
  auth, `$0` (computes the syndication token locally). Exit `3` on tombstone.
- `scripts/gh-repo-stats.js` — GitHub repo → stars/license/freshness +
  Claude-skill detection. Honors `GITHUB_TOKEN`.
- `references/sources.md` — handles, mirrors, similar sources, suspension note.
- `references/retrieval-playbook.md` — auth-wall-resistant retrieval order.
- `references/adoption-rubric.md` — six-dimension scoring, dedupe, gating.

## Quick checks

```bash
node scripts/hydrate-tweet.js https://x.com/heygurisingh/status/<id>
node scripts/gh-repo-stats.js owner/repo
```

## Invoke

`/gurisingh-scout` — or "gurisingh scout", "what's Guri Singh posting", "any new
Claude Code skills worth adding".