Trim the README and AGENTS.md, and cover skills and debugging

[bcherry]

Follow-up to #103, carrying over the review rounds on the Node starter (livekit-examples/agent-starter-node#65) so the two READMEs stay in step.

What

• AGENTS.md
  • Drops guidance a coding agent can work out on its own: the project-layout paragraph, the run-command walkthrough, and the "following is a guide" preamble. Tooling is now two lines (uv, and ruff for formatting).
  • Adds a section on the bundled livekit-agents skill, with a fallback path for tools that don't load skills on their own, and a debugging checklist.
• README
  • The feature list says what each piece does for you and links the docs for how. That covers Fish Audio as an expressive, cost-effective default, expressive mode, and adaptive interruption handling, which the starter enables but the list never mentioned.
  • "Using coding agents" shows lk docs search followed by lk docs get-page, since search only returns excerpts, and points to the bundled AGENTS.md and skill.
  • CLI install is a three-line list, with a link to the update instructions.
  • Manual setup includes the git clone it was missing.
  • "Run the agent" shows lk agent console and lk agent dev, then the direct uv run src/agent.py start for production. That's what the Dockerfile runs, so the old "the container doesn't include lk" caveat goes away.
  • "Testing and debugging" adds Agent Console and lk agent logs.
• Copy pass against the docs style guide: sentence-case headings, no "we", no hyphens standing in for dashes, bulleted rather than numbered lists where order doesn't matter, and less filler. The feature list mentions the simulation suite instead of the eval suite that Replace the pytest evals with the simulation suite #99 replaced, and links point at the current testing, observability, and workflows paths.

Notes for reviewers

• "Cost-effective" is based on LiveKit Inference pricing: Fish Audio S2.1 Pro is $15 per 1M characters, the lowest paid TTS tier, against $50 for Cartesia and $150–300 for ElevenLabs.
• The shared "LiveKit documentation" block in AGENTS.md only got light edits (heading case, grammar), since it's likely mirrored in other starters. It keeps "prefer browsing over search" and now adds that search results are excerpts to follow up with get-page.
• The branch's commit list includes Use lk agent for console, dev, and start #103's two commits and a no-op merge. The diff against main is only these two files, and a squash-merge keeps main clean.
• Every docs.livekit.io link in both files returns 200 without a redirect.

🤖 Generated with Claude Code

https://claude.ai/code/session_01U7yszNU7t5aCHJsKLmU4hv