Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ emails. Nuxt on Cloudflare Workers, D1, and Workers AI.
## Read first

- [`VISION.md`](VISION.md) β€” the product filter: mission, money posture, the two loops, seven principles, anti-scope. Read before any product, scope, design, or marketing decision. When it conflicts with the code, VISION wins.
- [`DESIGN.md`](DESIGN.md) β€” the visual filter: tokens, the three design principles, components, motion, the noise field, and the Avoid list. Read before UI work.
- [`DESIGN.md`](DESIGN.md) β€” the visual filter: tokens, the three design principles, components, motion, the brand system, and the Avoid list. Read before UI work.
- [`COPY.md`](COPY.md) β€” the verbal filter: the canonical strings, the register per context, and the banned language. Read before any user-visible string.
- [`GLOSSARY.md`](GLOSSARY.md) β€” every product concept. Read before a user-visible string, a public API name, a doc heading, or a route segment.
- [`docs/arch/README.md`](docs/arch/README.md) β€” the layers, the identity rule, the URL canonicals, and the server and app handler shapes.
Expand Down
32 changes: 26 additions & 6 deletions COPY.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,22 @@ 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 intro | Run a skill once and nothing lands on disk. Fork or install the ones you keep. Every skill comes from its maintainer's repo, and a person reads it before it's listed. | guidance only: the homepage intro under the H1 |
| Home claims line | Open-source CLI Β· Analytics without cookies or IPs Β· A skills.sh alternative | guidance only: the homepage claims line. The last item links to `/vs/skills-sh` |
| Promo label | Teach your agent skilld | guidance only: the homepage promo chip beside `npx skilld install skilld --global` |
| Tile: run | No more skill bloat: Run skills once off, fork, or install. | guidance only: a homepage tile, with the title before the colon. The run chip motif pairs with it |
| Tile: trending | Stay hyped: What devs talk about on X and Bluesky, weekly and monthly. | guidance only: a homepage tile. The braille spark motif pairs with it |
| Tile: changes | Keep updated: Watch repos and get a digest when their skills change. | guidance only: a homepage tile. The change grid motif pairs with it |
| Tile: platform | Built to be built on: CLI, API, SDK and MCP. | guidance only: a homepage tile |
| Home section: trending | Trending skills this week. | guidance only: the homepage trending section heading |
| Home section: changes | Keep up with skill changes. | guidance only: the homepage section heading for watching and the digest |
| Home section: authoring | Write a skill for your project. | guidance only: the homepage section heading for making a Skill |
| Claim: open source | open-source CLI | guidance only: the CLI. Never call skilld.dev or its site open source |
| 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` |

The homepage deck has no collection section. Its old heading, "Install a collection in one command.", is retired.

### The product in four lengths

Expand Down Expand Up @@ -131,21 +147,25 @@ near-miss is also banned.
| revolutionary, game-changing, supercharge, unlock, 10x, delightful, seamless, cutting-edge, next-generation, disrupt, empower, leverage (as a verb) | the mechanism, or the number | Startup register. The reader runs CI and can tell |
| AI-powered, intelligent, smart, magic, automate, autonomous, copilot (as a marketing term) | name what it does | skilld serves developers who use AI agents; it is not itself an AI product. "Agent" and "skill" stay fine as category nouns ("agent skills", "install a skill"); the ban is on "AI" modifying skilld itself |
| best, fastest, most powerful, ultimate, definitive | the specific claim, with evidence | A superlative without evidence is unfalsifiable. If something genuinely is the best at one thing, say why |
| vibrant community, ecosystem (community-size claims), passionate developers, beloved by thousands | the number | "6 curators", never "a growing community". Calling skilld an ecosystem is a category claim, not a size claim; see the exception below |
| vibrant community, ecosystem (community-size claims), passionate developers, beloved by thousands | the number | "6 curators", never "a growing community". Using "ecosystem" for a package category is not a size claim; see the exception below |
| named, naming, named by (in user-facing copy) | talked about, mentioned | Our internal words for the social-attribution route; they read as jargon. "3 devs talked about it", never "3 people named it". The technical sense survives in identifiers, ADRs and code comments, where the precision is the point |
| people (for our audience) | dev, devs | They are developers, and "people" is a vaguer word doing a smaller job. "Developers" in full is fine where the short form reads clipped |
| first person in a CTA | the content, then the destination | "We send this every Monday" spends the words on us. "Trending skills to your inbox every Monday" gives the reader both things that matter |
| privacy-friendly (bare) | analytics without cookies or IPs | A bare privacy claim cannot be checked. The mechanism can |
| open source (for the site or skilld.dev) | open-source CLI | A reader must be able to clone what the claim names, and the claim names the CLI |

**Exception, the humans-versus-generated claim.** When the contrast is authorship by a human
against machine generation, "human" and "person" are the right words and "dev" weakens the
point. "Curated agent skills by humans" and "person-authored skills" stay as they are. The rule
above is about naming our audience, not about the provenance claim.

**Exception, the homepage hero.** The 2026-09 homepage pivot made "Taste-tested agent skills
ecosystem" the landing H1 and the page title. That "ecosystem" names the category skilld
serves: skills across agents and package managers, written by their maintainers. It is not a
community-size claim, so the scoped ban above does not cover it. Package and learn pages use
the word in the same technical sense: npm, PyPI, crates, RubyGems.
**Exception, "ecosystem" as a category.** Package and learn pages use "ecosystem" in its
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
trending tile. 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.

## Open questions

Expand Down
Loading