Newcomer journey

Welcome. This page is the public newcomer journey for the AgentsKit ecosystem: understand → try → use → contribute → showcase.

Campaign landing: Community
Launch package (maintainers): docs/ecosystem/launch

Launch timing: Broad promotion stays blocked until ecosystem readiness is ready (#1204) and HITL approval is recorded in the launch package.

#1. Understand the ecosystem

Architecture overview: Architecture at a glance.

#2. Three-command demos

These demos are declared in docs/ecosystem/launch/launch-package.json and checked by pnpm check:launch-package. Public numbers must come from generated ecosystem-claims.json.

#Demo A — first agent (no provider key)

npm install @agentskit/core @agentskit/runtime tsx
cp apps/docs-next/fixtures/first-agent/agent.ts ./agent.ts
npx tsx agent.ts

Expected output includes: Agent ready. I received: Plan my first production agent.

#Demo B — start from the Registry

open https://registry.agentskit.io/agents
npx agentskit add research
cat agents/research/agent.ts | head

#Demo C — apply Playbook discipline

open https://playbook.agentskit.io/docs
curl -s https://playbook.agentskit.io/llms.txt | head -n 20
open https://playbook.agentskit.io/docs/onboard-your-agent

#3. Choose a use path

• Chat UI → UI
• Autonomous agents → Agents
• RAG / memory → Data
• Production ops → Production
• Package API → Reference

#4. Contribute

1. Read Contributing, Code of Conduct, and Security.
2. Complete local setup.
3. Claim a good first issue (each curated starter lists setup + test commands).
4. Open a draft PR early and link the issue.

Maintainer response expectations: Maintainer expectations.

#5. Showcase and recipes

Built something useful? Submit a showcase entry or recipe through Recipe & showcase submission.

#Metrics we care about

Understanding, activation, use, contribution, and retention — defined in Launch metrics.