docs: update READMEs, docs, and homepage for new skill structure

Remove references to old granular skills (core, cli, scopes-and-context,
sessions-and-tags, testing) and replace with the two-skill setup:
agentcrumbs (top-level) and agentcrumbs/init.

Author: ericallam

README.md

@@ -29,11 +29,8 @@ agentcrumbs ships with [@tanstack/intent](https://tanstack.com/blog/from-docs-to
 
 | Skill | What it teaches |
 | --- | --- |
+| `agentcrumbs` | Core workflow, API, markers, CLI reference, common mistakes |
 | `agentcrumbs/init` | Scans repo, discovers namespaces, writes config |
-| `agentcrumbs/core` | `trail()`, `crumb()`, markers, env var, noop guarantee |
-| `agentcrumbs/scopes-and-context` | `scope()`, `wrap()`, `child()`, `snapshot()`, `assert()` |
-| `agentcrumbs/sessions-and-tags` | `session()`, tags, grouping and filtering |
-| `agentcrumbs/cli` | `collect`, `tail`, `query`, `strip`, `session` |
 
 Skills travel with the package version. The agent always has docs matching the installed code.
 

docs/content/docs/skills.mdx

@@ -30,43 +30,34 @@ Each skill is a Markdown file with YAML frontmatter:
 
 ```yaml
 ---
-name: agentcrumbs/core
+name: agentcrumbs
 description: >
-  Core debug tracing with agentcrumbs: trail(), crumb(),
-  @crumbs markers, env var config, noop strategy...
+  Debug mode for AI coding agents. Drop structured traces inline
+  while writing code, query them when something breaks, strip
+  before merge.
 type: core
 library: agentcrumbs
-library_version: "0.1.0"
+library_version: "0.2.0"
 sources:
+  - "triggerdotdev/agentcrumbs:README.md"
   - "triggerdotdev/agentcrumbs:src/trail.ts"
-  - "triggerdotdev/agentcrumbs:src/env.ts"
 ---
 ```
 
-The content includes correct usage patterns, explicitly flags common mistakes, and defines constraints the agent must follow.
+The content includes correct usage patterns, explicitly flags common mistakes, and points agents to CLI help and docs for deeper discovery.
 
 ## Available skills
 
 | Skill | What it teaches |
 | --- | --- |
+| `agentcrumbs` | Core workflow, API, markers, CLI quick reference, critical mistakes, and pointers to further discovery |
 | `agentcrumbs/init` | Scans repo structure, discovers namespaces, writes config to CLAUDE.md or .cursorrules |
-| `agentcrumbs/core` | `trail()`, `crumb()`, `// @crumbs` markers, `#region @crumbs` blocks, env var, noop guarantee |
-| `agentcrumbs/scopes-and-context` | `scope()`, `wrap()`, `child()`, `snapshot()`, `assert()`, context propagation |
-| `agentcrumbs/sessions-and-tags` | `session()`, tags, grouping crumbs for replay and filtering |
 
-| `agentcrumbs/cli` | `collect`, `tail`, `query`, `strip`, `session`, and other CLI commands |
-
-## What each skill contains
-
-**Patterns.** Correct usage examples the agent can copy. These show the right way to use each API, with proper markers, at module scope, with structured data.
-
-**Common mistakes.** Explicitly marked with severity levels (CRITICAL, HIGH, MEDIUM). Things like: checking `process.env.AGENTCRUMBS` on every call instead of using the noop, creating `trail()` inside request handlers, forgetting `// @crumbs` markers. The agent learns what to avoid, not just what to do.
-
-**Constraints.** Hard rules: every crumb line must have a marker, don't invent namespaces without checking the catalog, create trails at module scope.
+The top-level `agentcrumbs` skill covers the essentials an agent needs to use crumbs correctly: the write-collect-query-strip workflow, core API (`trail`, `crumb`, `child`, `scope`), marker syntax, and the most common mistakes. For deeper functionality like sessions, tags, scopes, and testing patterns, it points agents to CLI help (`agentcrumbs --help`), type definitions, and the docs.
 
 ## The init skill
 
-The `agentcrumbs/init` skill deserves special mention. It's the entry point for setting up agentcrumbs in any project.
+The `agentcrumbs/init` skill is the entry point for setting up agentcrumbs in any project.
 
 When the agent runs init, it:
 
@@ -81,9 +72,8 @@ After init, every agent working in the repo uses the same consistent namespaces.
 If you don't use @tanstack/intent, you can point agents to skills directly:
 
 ```
-skills/agentcrumbs/core/SKILL.md
-skills/agentcrumbs/cli/SKILL.md
-skills/agentcrumbs/init/SKILL.md
+node_modules/agentcrumbs/skills/agentcrumbs/SKILL.md
+node_modules/agentcrumbs/skills/agentcrumbs/init/SKILL.md
 ```
 
 Or add a reference in your agent config file manually. But `npx @tanstack/intent install` handles all of this automatically.

docs/src/app/page.tsx

@@ -248,7 +248,7 @@ export default function HomePage() {
           </div>
 
           <div className="hp-skills-detail">
-            <p>agentcrumbs ships 5 skills via <a href="https://tanstack.com/blog/from-docs-to-agents" target="_blank">@tanstack/intent</a>, covering the full API, CLI, and common mistakes. Skills travel with the package version, so the agent always has docs matching the installed code.</p>
+            <p>agentcrumbs ships 2 skills via <a href="https://tanstack.com/blog/from-docs-to-agents" target="_blank">@tanstack/intent</a>: one covering the core workflow, API, and common mistakes, and an init skill that sets up your repo. Skills travel with the package version, so the agent always has docs matching the installed code.</p>
             <p>Compatible with Claude Code, Cursor, GitHub Copilot, and any agent that supports the <a href="https://agentskills.io" target="_blank">Agent Skills spec</a>.</p>
           </div>
         </div>

packages/agentcrumbs/README.md

@@ -29,11 +29,8 @@ agentcrumbs ships with [@tanstack/intent](https://tanstack.com/blog/from-docs-to
 
 | Skill | What it teaches |
 | --- | --- |
+| `agentcrumbs` | Core workflow, API, markers, CLI reference, common mistakes |
 | `agentcrumbs/init` | Scans repo, discovers namespaces, writes config |
-| `agentcrumbs/core` | `trail()`, `crumb()`, markers, env var, noop guarantee |
-| `agentcrumbs/scopes-and-context` | `scope()`, `wrap()`, `child()`, `snapshot()`, `assert()` |
-| `agentcrumbs/sessions-and-tags` | `session()`, tags, grouping and filtering |
-| `agentcrumbs/cli` | `collect`, `tail`, `query`, `strip`, `session` |
 
 Skills travel with the package version. The agent always has docs matching the installed code.