Skip to content

refactor: replace npx-first onboarding with agent-native fetch flow#92

Merged
raymondk merged 1 commit intomainfrom
refactor/agent-first-onboarding
Mar 20, 2026
Merged

refactor: replace npx-first onboarding with agent-native fetch flow#92
raymondk merged 1 commit intomainfrom
refactor/agent-first-onboarding

Conversation

@marc0olo
Copy link
Member

@marc0olo marc0olo commented Mar 20, 2026

Summary

  • llms.txt is now pure agent instructions — fetch the index, fetch skills by name, prefer skills over general knowledge. No npx, no skills listing.
  • Get Started page offers three tiers: paste a prompt (ephemeral), add AGENTS.md to your repo (persistent), or use the CLI (npx skills add)
  • Browse page replaces search bar + npx hint with a single hero CTA button that copies the agent prompt
  • Skill detail pages now use the shared SiteLayout (consistent header/nav), removing the custom SkillHeader component
  • New /AGENTS.md endpoint — downloadable agent instructions file, ready to commit to any repo
  • Fetch URLs and install commands removed from skill cards — humans don't need them, agents use index.json
  • Mobile overflow fixes across all pages
  • Consistent page widths (all 1200px), consistent heading punctuation

Context: dfinity/icp-cli#453, dfinity/icp-cli-templates#22

Agents are always online — they don't need CLI installs. Rewrite the
entire onboarding story around WebFetch: llms.txt tells agents what to
do, humans just copy one prompt or drop an AGENTS.md into their repo.

Key changes:

- llms.txt: pure agent instructions (fetch index, fetch skills, prefer
  skills over general knowledge) — no npx, no skills listing
- Get Started: three tiers — paste prompt, add AGENTS.md, use CLI
- Browse: single hero CTA button that copies the agent prompt
- Skill pages: use SiteLayout for consistent header, remove SkillHeader
- New /AGENTS.md endpoint: downloadable agent instructions file
- Remove search from browse page (agents search via index.json)
- Remove fetch URLs from skill cards (humans don't need them)
- Mobile overflow fixes across all pages
@raymondk raymondk merged commit 351e6c3 into main Mar 20, 2026
6 checks passed
@raymondk raymondk deleted the refactor/agent-first-onboarding branch March 20, 2026 15:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants