Skip to content

refactor: overhaul site messaging — prioritize npx install, remove llms-full.txt#85

Merged
raymondk merged 1 commit intomainfrom
refactor/site-messaging-and-access
Mar 16, 2026
Merged

refactor: overhaul site messaging — prioritize npx install, remove llms-full.txt#85
raymondk merged 1 commit intomainfrom
refactor/site-messaging-and-access

Conversation

@marc0olo
Copy link
Member

Summary

  • Remove llms-full.txt — violates progressive disclosure, incomplete for multi-file skills (e.g. icp-cli references), grows unbounded
  • Rewrite llms.txt — concise skill index with install commands, discovery links, and skill listing by name (not title)
  • Rename "access" → "get started" — new tab label, URL /get-started/, component renamed to GetStartedTab. Restructured into tiered sections: npx install (3 variants) → discovery endpoints → info cards
  • Add npx skills add --skill <name> to skill detail pages and browse cards — previously only showed raw URL
  • Rewrite how-it-works 3-step flow — "Without skills / One command / With skills" using concrete ckBTC prompt story instead of abstract canister ID examples
  • Update terminal examplenpx skills add as primary, single curl as secondary. Removed llms-full.txt curl
  • OG image — updated to match current branding (black/white, "ICP Skills — for agents that write code"), converted to PNG for social platform compatibility (SVG not supported by Twitter/X, LinkedIn, Slack)
  • README — fixed hosting (IC asset canister, not GitHub Pages), canonical .well-known URLs instead of raw.githubusercontent.com, cleaned up programmatic access table, "any agent" instead of unsourced "40+"
  • CLAUDE.md — updated project structure to match all renames

Not changed (needs discussion)

Browse page subtitle (BrowseTab.tsx:45-47) — generic ICP marketing copy from PR #84. The H1 is good but the subtitle describes the platform, not the product.

…ms-full.txt

- Remove llms-full.txt (violates progressive disclosure, incomplete for multi-file skills)
- Rewrite llms.txt as concise skill index with install commands and discovery links
- Restructure "access" page → "get started" with tiered install/discovery/info sections
- Add npx skills install command to skill detail pages and browse cards
- Rewrite how-it-works 3-step flow with concrete before/after prompt story
- Update OG image to PNG (social platform compat) with current branding
- Fix README: canonical .well-known URLs, correct hosting, clean up table
- Update CLAUDE.md project structure to match
@raymondk raymondk merged commit abee871 into main Mar 16, 2026
6 checks passed
@raymondk raymondk deleted the refactor/site-messaging-and-access branch March 16, 2026 17:59
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