From 982d0537eff18a7dd86c0b8afae4d093c46e3456 Mon Sep 17 00:00:00 2001 From: Harlan Wilton Date: Tue, 6 Oct 2026 12:40:07 +1100 Subject: [PATCH] feat(home): lead the hero with what sets skilld apart The old hero spent its words defining skills and leaned on "hyped". Visitors already know what a Skill is, so the caption now names only the two differences: try before install, and an agent that searches on its own. The claims line gains "no telemetry", which the CLI README states and the skills.sh CLI does not offer by default. --- COPY.md | 12 ++++++------ GLOSSARY.md | 2 +- app/pages/index.vue | 27 +++++++++++++++++---------- scripts/lib/production-smoke.ts | 2 +- test/unit/production-smoke.test.ts | 2 +- 5 files changed, 26 insertions(+), 19 deletions(-) diff --git a/COPY.md b/COPY.md index 474a9e8f..14c8c1fa 100644 --- a/COPY.md +++ b/COPY.md @@ -22,11 +22,11 @@ These exact strings. Do not paraphrase them per page. | Tagline | Curated agent skills by humans. | index OG image alt | | Site description | Curated agent skills by humans, written by real maintainers in their own GitHub repos | `nuxt.config.ts` site description (feeds every page's meta description) | | Elevator pitch | Skilld is a curated registry of agent skills written by real people in the GitHub repos you already depend on. One install command, every agent; watch your stack and get a digest when it changes. | guidance only: no page ships it yet (use it where two sentences fit) | -| Home H1 | Hyped agent skills, no bloat | guidance only: the homepage H1. The page draws the rose brand dot as its full stop, so never type a period | +| Home H1 | Agent skills for you and your agent | guidance only: the homepage H1. The page draws the rose brand dot as its full stop, so never type a period | | Home verb line | search · run · install · keep current | guidance only: the homepage line under the H1. Each verb links to its `/cli` section: `#search`, `#run`, `#install`, `#update` | | Home CLI link | The skilld CLI → | guidance only: the homepage link to `/cli` at the end of the verb line. The arrow is an icon | -| Home caption | skilld.dev finds and tracks skills. The CLI runs or installs them in 19 agents. | guidance only: the homepage caption under the verb line. 19 is `AGENT_TARGETS` in the CLI's `crates/skilld-core/src/target.rs`. If that count changes, change this string | -| Home claims line | Open-source CLI · Analytics without cookies or IPs · A skills.sh alternative | guidance only: the homepage claims line under the search. The third item links to `/vs/skills-sh`, and the promo label closes the line | +| Home caption | Try any skill before you install it. Your agent can search for its own. | guidance only: the homepage caption under the verb line. It assumes the reader knows what a Skill is, so it names only what sets skilld apart. "Search for its own" is the skilld Skill behind the promo label | +| Home claims line | Open-source CLI, no telemetry · Analytics without cookies or IPs · A skills.sh alternative | guidance only: the homepage claims line under the search. The third item links to `/vs/skills-sh`, and the promo label closes the line | | Promo label | Teach your agent skilld | guidance only: the last item of the homepage claims line. It opens a popover with `npx skilld install skilld --global` | | Step 01: find | Find · Stay hyped. A curated registry, plus what devs talk about on X and Bluesky. | guidance only: the first step of the homepage lifecycle band. The step name comes first, then the pitch line, then the description. Links `/skills/trending`. The braille spark motif pairs with the pitch line | | Step 02: run | Run · No more skill bloat. Your Agent reads the Skill now. Nothing lands on disk. | guidance only: a homepage lifecycle step. Links `/cli#run`. It carries the band's one rose dot, because run is the default. The run chip motif pairs with the pitch line | @@ -44,6 +44,7 @@ These exact strings. Do not paraphrase them per page. | CLI claims line | Open-source CLI · No telemetry · 19 Agent targets | guidance only: the `/cli` claims line. The page counts the `--agent` values of `skilld install --help` | | CLI install label | Install the CLI | guidance only: the label beside `npm install --global skilld` on `/cli` | | Claim: open source | open-source CLI | guidance only: the CLI. Never call skilld.dev or its site open source | +| Claim: telemetry | no telemetry | guidance only: the CLI. Its README states that it sends no telemetry or analytics. Never say it of the site, which keeps anonymous analytics | | Claim: privacy | analytics without cookies or IPs | guidance only: analytics and privacy copy. Never the bare "privacy-friendly" | | Claim: comparison | skills.sh alternative | guidance only: always a link to `/vs/skills-sh` | @@ -192,9 +193,8 @@ above is about naming our audience, not about the provenance claim. technical sense: npm, PyPI, crates, RubyGems. That names a category, not a community size, so the scoped ban above does not cover it. -**Exception, "hyped".** Harlan approved "hyped" for the homepage H1 and "Stay hyped" for the -find step of the homepage lifecycle band. Both name what devs talk about on X and Bluesky, -which we measure and show. Use them only for social trending. "Hot", "popular" and "top" stay banned. +**Exception, "hyped".** Harlan approved "Stay hyped" for the find step of the homepage +lifecycle band. It names what devs talk about on X and Bluesky, which we measure and show. Use "hyped" only for social trending. "Hot", "popular" and "top" stay banned. ## Open questions diff --git a/GLOSSARY.md b/GLOSSARY.md index efacd921..4ebf371c 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -152,7 +152,7 @@ Collisions **Is:** Skills ranked by devs talking about them on X and Bluesky (ADR-0004). Never by installs. -**Marketing phrase:** "hyped", as in the homepage H1 and the "Stay hyped" step. It names the same social signal. +**Marketing phrase:** "hyped", as in the "Stay hyped" step. It names the same social signal. **Never:** popular, hot, top, leaderboard. diff --git a/app/pages/index.vue b/app/pages/index.vue index 4fa1e270..169518ce 100644 --- a/app/pages/index.vue +++ b/app/pages/index.vue @@ -7,8 +7,8 @@ import { avatarProxyUrl, githubAvatarProxyUrl } from '#shared/image-proxy' import { TRENDING_RANGES } from '#shared/trending-range' import OutcomeClusterGrid from '../components/OutcomeClusterGrid.vue' -const title = 'Taste-tested agent skills ecosystem · skilld' -const description = 'Agent skills written by their maintainers and read by a person before they go in. See what devs are sharing this week, find what your agent needs, and keep up when it changes.' +const title = 'Agent skills for you and your agent · skilld' +const description = 'Try any agent skill before you install it, and let your agent search for its own. Open-source CLI, no telemetry. A skills.sh alternative.' useSeoMeta({ title, @@ -232,8 +232,8 @@ function recentUpdateDescription(item: RecentUpdateCard): string {

- Hyped agent skills, - no bloat.

@@ -250,18 +250,18 @@ function recentUpdateDescription(item: RecentUpdateCard): string { The skilld CLI