Karpathy Skills vs Perplexity Sonar Pro 2 API

“32,000 GitHub stars don't lie. Four principles that actually address the most painful Claude Code failure modes: hidden assumptions before coding, overengineering beyond scope, cosmetic edits to unrelated code, and vague instructions without measurable success criteria. Install it as a Claude Code plugin once and every project benefits. The fact that Karpathy's specific critique — models 'make wrong assumptions, overcomplicate code, and introduce unrelated changes' — maps exactly to the four principles shows this came from real pain, not theorizing.”

“The primitive here is clear: grounded web synthesis with streaming citations exposed as an API endpoint, not a chat UI you have to scrape. The DX bet is that streaming citations alongside the reasoning trace is the right abstraction — and it is, because it lets you build trust signals into your app without reinventing retrieval. The moment of truth is whether the citation stream is parseable and stable enough to build on, and from the docs it looks like it actually is. This isn't something you replicate with a weekend script — you'd need a search index, a reranker, and a streaming LLM pipeline just to get to baseline. Ship for the specific case of building research-heavy features; skip if you just need vanilla RAG.”

“It's a text file. A well-written text file with excellent branding, but a text file. CLAUDE.md files are advisory — models will still violate these principles when the context gets long, when a prompt is ambiguous, or when the model just decides to. The 32,000 stars reflect the 'Karpathy said it' effect more than validated outcomes. If your Claude sessions are regularly failing from overengineering, the fix is better task decomposition in your prompts, not a rules file that competes with 200k tokens of other context.”

“Direct competitor is the Bing Grounding API in Azure OpenAI and Google's Grounding with Search in Gemini — both of which are backed by companies with vastly deeper index infrastructure. Perplexity's actual differentiator is the multi-step reasoning loop and the citation streaming, which neither competitor does as cleanly at the API level today. The scenario where this breaks is enterprise legal or compliance contexts where you need source provenance guarantees, not just URL citations — that's still a black box. What kills this in 12 months: OpenAI ships deep research natively in the API with better citation tooling, which is a near-certainty. The window is real but narrow, so ship now with eyes open.”

“The meta-trend here is that the prompt engineering layer is getting commoditized and shared. Karpathy Skills is an early signal that domain experts' hard-won prompt patterns will become infrastructure — installed by default, maintained as a community, and eventually incorporated into model training itself. The 9,000+ stars gained in a single day suggests this fills a real gap that wasn't being addressed by official tooling.”

“The thesis here is falsifiable: by 2027, applications will need grounded, multi-step reasoning as a commodity API layer, not as a consumer product. That bet depends on LLM hallucination rates staying high enough that citation grounding remains valuable, and on Perplexity maintaining crawl freshness that model providers can't match with training data alone. The second-order effect that matters: if this API wins adoption, Perplexity becomes infrastructure for a generation of research-adjacent apps, which means they collect query data that trains the next model cycle — a compounding moat that's actually real. The trend line is the shift from static RAG to agentic search-and-synthesize; Perplexity is on-time, not early, but executing better than most. The future state where this is infrastructure is every B2B SaaS with a research or due-diligence feature.”

“Even if the impact is 30% better behavior rather than 100%, that compounds across every session. For any creator using Claude Code to build tools, sites, or prototypes, having the 'think before coding' and 'surgical changes only' principles baked into every project costs nothing and occasionally saves an hour of undo work.”

“The buyer here is a developer at a company building a research or knowledge product, pulling from a product or engineering budget — fine. But $5 per 1,000 requests sounds cheap until you model the usage: a mid-size B2B app running 50,000 deep research queries a month is paying $250 just in API costs before any other infrastructure, and deep research queries are the expensive ones. The moat problem is the real issue: Perplexity's defensibility is the quality of their search index and the reasoning loop, but both Google and Microsoft are actively eroding this with grounding APIs backed by better crawl infrastructure. There's no workflow lock-in, no proprietary data flywheel on the API side, and no pricing architecture that scales with customer success rather than against it. I'd want to see a clear story for why enterprise customers choose this over Azure Grounding in 18 months before I called it viable.”