diff --git a/.claude/context/brand-guidelines.md b/.claude/context/brand-guidelines.md
index 9d83d470..74c3defb 100644
--- a/.claude/context/brand-guidelines.md
+++ b/.claude/context/brand-guidelines.md
@@ -16,7 +16,7 @@ Skills are knowledge, not packages, and knowledge has an author. A skill is wort
 
 ### Two loops
 
-- **Loop 1 — Activation:** anonymous discovery → install. Land, copy, run. No friction.
+- **Loop 1 — Activation:** anonymous discovery → run. Land, copy, run. No friction. Install is the opt-in second step.
 - **Loop 2 — Retention:** sign in with GitHub, watch your stack, get a weekly digest of what changed.
 
 ## Positioning
@@ -25,7 +25,7 @@ Skills are knowledge, not packages, and knowledge has an author. A skill is wort
 - A curated registry of AI agent skills written by real people in their own GitHub repos
 - A provenance layer: every skill links back to the repo and the maintainer who wrote it
 - Organization-owned skills stay in the registry and stay searchable. The homepage leads with skills by identifiable people because provenance is the point, but org skills are ranked lower, not excluded
-- One install command, every agent: `npx skilld add gh:owner/repo`
+- One command, every agent: `npx skilld@beta run skilld:owner/repo/skill` to use a skill now, `npx skilld@beta install skilld:owner/repo/skill` to keep it
 - A watch-for-changes layer: sign in with GitHub, get a digest when watched repos change
 
 ### What we are not
@@ -59,16 +59,16 @@ The pitch: Context7 gives you docs. skills.sh gives you a leaderboard. Skilld gi
 | Term | Definition | Usage notes |
 |------|-----------|-------------|
 | **skill** | A SKILL.md file that gives an AI agent domain knowledge | Lowercase always. Not "plugin", "extension", or "module" |
-| **package skill** | A skill tied to a specific npm package, bootstrapped with `skilld author` and owned, edited, and published by its maintainer in their own repo | Never platform-authored; the platform publishes no skills (VISION anti-scope 1) |
+| **package skill** | A skill tied to a specific npm package, drafted with the skilld-maintained `generate-package-skill` Skill and owned, edited, and published by its maintainer in their own repo | Never platform-authored; the platform publishes no skills (VISION anti-scope 1) |
 | **guide skill** | A curation tag on skilld.dev for skills not tied to a package | Distributed as git skills, tagged for filtering in browse views |
 | **collection** | A curated bundle of skills assembled by a collection author | Not "preset", "pack", "bundle", or "kit" in UI (fine in marketing prose) |
 | **author** / **curator** | A developer who maintains one or more collections on skilld. Identity is their GitHub login. | Either word is fine; "curator" reads warmer in editorial copy, "author" in product UI |
 | **registry** | skilld.dev, the central hub for curated agent skills | Also hosts the MCP server |
-| **install** | Adding a skill or collection to your agent's configuration | Not "download". `skilld add` is the canonical CLI verb |
+| **run** | Handing the agent a skill for the current session. `skilld run` prints the skill and writes no file | The default verb. Every skill surface leads with the run command. Not "try", "preview", "use once", or "ephemeral" |
+| **install** | Adding a skill or collection to your agent's configuration as local files | Not "download", not "add". `skilld install` is the opt-in second step, for a skill worth keeping in every session |
 | **agent** | The coding tool that reads skills: Claude Code, Codex, Cursor, Gemini CLI, and the rest of the CLI's targets | Not "client", "tool", "editor", or "IDE". Say "your agent" in UI; name a specific agent only inside the setup picker |
 | **project install** | Installing into the current repository, the default | UI label: "Project". Not "local" |
 | **global install** | Installing into the agent's home directory, so every project sees the skill | UI label: "Global". Not "system-wide" |
-| **use once** | Pasting a prompt that points the agent at the published SKILL.md, so it reads and follows the skill without writing files | UI label: "Use once". Not "try", "preview", or "ephemeral". Only offered where a public markdown URL exists |
 | **watch** | Subscribing to a repo or collection so you receive digest emails when it changes | The Loop 2 verb. Not "follow", not "star", not "subscribe" |
 | **digest** | Periodic email summarizing changes to your watched repos | Weekly default; daily and off are options |
 | **weekly** | The one email everyone gets: skills you liked that changed, plus what trended | Lowercase, "the weekly". Not "newsletter", "roundup", or "trending digest". Opt-out, on by default. Sits beside **digest**, which is the separate watched-repo email |
@@ -76,7 +76,7 @@ The pitch: Context7 gives you docs. skills.sh gives you a leaderboard. Skilld gi
 ### Feature naming
 - Name features descriptively, not cleverly. "Stack selector" not "StackMatch"
 - No trademark-style capitalization for features (not "Smart Collections")
-- CLI commands use lowercase: `skilld add`, `skilld update`, `skilld author`
+- CLI commands use lowercase: `skilld run`, `skilld install`, `skilld update`
 
 ## Voice & Tone
 
diff --git a/GLOSSARY.md b/GLOSSARY.md
new file mode 100644
index 00000000..1c7b09fc
--- /dev/null
+++ b/GLOSSARY.md
@@ -0,0 +1,159 @@
+# Glossary
+
+Canonical vocabulary for skilld.dev. Every user-visible string, public API name, doc heading, and route segment uses these terms and no synonyms.
+
+Shared terms match the skilld CLI glossary (`skilld-dev/skilld/GLOSSARY.md`). That file wins for CLI commands, protocol types, and source status values. Voice and tone live in `.claude/context/brand-guidelines.md`.
+
+## Map
+
+| Term | Owner | Relation | Customer word |
+| --- | --- | --- | --- |
+| Skill | GitHub Repository, `layers/registry` | Repository 1—N Skill | "skill" |
+| Agent | the user's tool | Agent 1—N Agent target | "your agent" |
+| Repository | GitHub | Repository 1—N Skill | "repository" |
+| Artifact | skilld.dev API | Skill commit 1—1 Artifact | not shown |
+| source status | lockfile, skilld.dev API | Artifact 1—1 source status | "Verified", "Unverified", "Local" |
+| run | skilld CLI | Skill 1—1 run command | "run" |
+| install | skilld CLI | Skill 1—1 install command | "install" |
+| lockfile | skilld CLI | project 1—1 lockfile | "lockfile" |
+| curator | `layers/collections`, `/@login` | curator 1—N collection | "curator" |
+| collection | `layers/collections`, `/@login/slug` | collection N—N Skill | "collection" |
+| watch | `layers/identity` | account N—N Repository or collection | "watch" |
+| digest | `layers/identity` email | account 1—1 digest schedule | "digest" |
+| trending | `/skills/trending`, ADR-0004 | Repository 1—N social mention | "trending" |
+| registry | skilld.dev | one | "skilld" |
+| provenance | Skill detail, cards | Skill 1—1 author and source link | "written by", "source" |
+
+Collisions
+
+- "Verified" names a source status only. Never a safety claim, never a sync time.
+- "curator" and "author" both surface on profile pages. A curator assembles collections. An author writes a Skill.
+
+## Terms
+
+### Skill
+
+**Is:** a directory with a `SKILL.md` that follows the Agent Skills specification, written by a maintainer in their own Repository.
+
+**Never:** prompt, plugin, extension, module, guide.
+
+**Casing:** `Skill` in new product prose. Existing UI uses lowercase `skill`; see Open questions.
+
+### Agent
+
+**Is:** the coding tool that reads Skills: Claude Code, Codex, Cursor, Gemini CLI, and the rest of the CLI's targets.
+
+**Never:** client, tool, editor, IDE.
+
+**Casing:** `Agent` in prose, "your agent" in UI.
+
+### Repository
+
+**Is:** a GitHub repository that contains one or more Skills. The source of truth.
+
+**Never:** package host, registry entry. `repo` stays in identifiers and existing UI labels.
+
+### Artifact
+
+**Is:** immutable Skill bytes resolved from one exact source commit, delivered by the skilld.dev API to the skilld CLI.
+
+**Never:** hosted Skill, registry package, upload.
+
+### source status
+
+**Is:** the recorded provenance state for an installed Skill: `verified`, `local`, or `unverified`.
+
+**Use for:** the receipts panel and lockfile values. "Verified" means the Artifact attestation checked out.
+
+**Never:** safety state, trust score, "verified safe", a sync timestamp.
+
+### run
+
+**Is:** `skilld run`. The Agent reads the Skill for the current session and nothing lands on disk. The default command on every Skill surface.
+
+**Never:** try, preview, use once, ephemeral.
+
+### install
+
+**Is:** `skilld install`. Skill files land in the project and the lockfile records them. The opt-in second step.
+
+**Never:** add, download.
+
+### lockfile
+
+**Is:** the file the skilld CLI writes to record installed Skills, their commits, and source status.
+
+**Never:** manifest, registry file.
+
+### curator
+
+**Is:** a developer who assembles one or more collections. Identity is their GitHub login at `/@login`.
+
+**Use for:** collection pages, the `/community` directory, "Browse curators".
+
+**Never:** creator, publisher (for a person), "the Community" as a proper noun.
+
+### collection
+
+**Is:** a curated set of Skills assembled by a curator, with a reason per Skill, at `/@login/slug`.
+
+**Never:** preset, pack, bundle, kit, stack (in UI).
+
+### watch
+
+**Is:** subscribing to a Repository or collection so the digest reports its changes. The Loop 2 verb.
+
+**Never:** follow, star, subscribe, sync.
+
+### digest
+
+**Is:** the email that summarises changes to watched Repositories. Weekly by default; daily and off are options.
+
+**Never:** newsletter, notification, alert. "the weekly" is the separate opt-out email.
+
+### trending
+
+**Is:** Skills ranked by devs talking about them on X and Bluesky (ADR-0004). Never by installs.
+
+**Never:** popular, hot, top, leaderboard.
+
+### registry
+
+**Is:** skilld.dev, the curated index of Skills and the discovery MCP server.
+
+**Never:** marketplace, store, hub, catalog (in UI).
+
+### provenance
+
+**Is:** who wrote a Skill and the exact `SKILL.md` in their Repository. The quality signal.
+
+**Use for:** "written by {user}" on user pages, "published by {org}" on organization pages, source links.
+
+**Never:** trust score, verification tier, "curated by" for an author.
+
+## Banned
+
+| Never | Use instead | Why |
+| --- | --- | --- |
+| follow | watch | One Loop 2 verb |
+| sync (user-facing) | import (stars), "Checked GitHub {ago}" (freshness) | Internal jargon; say what happened |
+| use once, try, preview | run | One name for the transient path |
+| add (CLI verb) | run or install | v2 grammar |
+| popular, install count | starred, stars | Installs never rank or trust |
+| verified safe, secure, scanned | name the exact check | An attestation cannot guarantee safety |
+| people (audience) | devs | Brand guidelines |
+| Community (proper noun) | curators, `/community` route | Unglossed; the route stays |
+| named, naming (user copy) | talked about, mentioned | Internal word for the social route |
+| AI-powered | (cut) | skilld is not an AI product |
+
+## Open questions
+
+Naming calls this file does not settle. Resolve one, fold the answer in, delete the entry.
+
+1. **`Skill` or `skill` in site UI?**
+   The CLI glossary and new v3 copy use `Skill`. Most existing site UI, brand-guidelines.md, and meta descriptions use lowercase `skill`.
+   - Recase the site to `Skill`, one sweep, touches hundreds of strings.
+   - Keep lowercase on the site, record the split as deliberate.
+2. **`repo` or `repository` in site UI?**
+   The CLI glossary bans `repo`. The site uses `repo` in labels, props, and routes (`/gh/owner/repo`).
+   - Ban in new prose only, keep identifiers and routes.
diff --git a/app/components/community/_CommunityCreator.vue b/app/components/community/_CommunityCreator.vue
index 49eec4f8..d785c341 100644
--- a/app/components/community/_CommunityCreator.vue
+++ b/app/components/community/_CommunityCreator.vue
@@ -119,7 +119,7 @@ function formatStars(stars: number): string {
       >
         <span class="flex items-center justify-between gap-4">
           <span class="font-mono text-sm uppercase tracking-widest text-muted">
-            Most popular skill
+            Most starred skill
           </span>
           <UIcon
             name="i-lucide-arrow-up-right"
diff --git a/app/pages/@[login]/index.vue b/app/pages/@[login]/index.vue
index f9f2357f..0f0fcf89 100644
--- a/app/pages/@[login]/index.vue
+++ b/app/pages/@[login]/index.vue
@@ -198,7 +198,7 @@ defineOgImage('Curator.takumi', {
   collectionCount: () => collections.value.length,
   skillCount: () => skills.value.length,
   skills: () => skills.value.slice(0, 4).map(skill => skill.display_name || skill.name),
-}, { alt: () => `${displayName.value} Community profile on skilld` })
+}, { alt: () => `${displayName.value} curator profile on skilld` })
 </script>
 
 <template>
@@ -573,7 +573,7 @@ defineOgImage('Curator.takumi', {
         <UButton
           v-else
           to="/community"
-          label="Browse Community"
+          label="Browse curators"
           icon="i-lucide-arrow-right"
           trailing
           color="neutral"
diff --git a/app/pages/collections/new.vue b/app/pages/collections/new.vue
index e2f0672a..414479cd 100644
--- a/app/pages/collections/new.vue
+++ b/app/pages/collections/new.vue
@@ -4,7 +4,7 @@ const { isAuthenticated, user, loginUrl } = useAuth()
 
 useSeoMeta({
   title: 'New Collection',
-  description: 'Bundle the skills you reach for into a named collection.',
+  description: 'Bundle the skills you reach for into a collection.',
   robots: 'noindex',
 })
 
diff --git a/app/pages/index.vue b/app/pages/index.vue
index 0b046b28..2622173d 100644
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -245,6 +245,13 @@ const installCommand = computed(() => {
     : ''
 })
 
+/**
+ * The authoring story runs a skilld-maintained Skill. The CLI itself never
+ * drafts a Skill, so the band hands the visitor the same run command every
+ * other surface prints.
+ */
+const authoringRunCommand = skillRunCmd('skilld-dev', 'skilld', 'generate-package-skill')
+
 const installTarget = computed<InstallTarget | null>(() => {
   const collection = leadCollection.value
   return collection
@@ -412,7 +419,7 @@ function recentUpdateDescription(item: RecentUpdateCard): string {
               Collections for better agent work.
             </h2>
             <p class="mt-4 max-w-xl text-base leading-relaxed text-muted text-pretty">
-              Shared by devs in the skilld community, covering discovery, planning, and review.
+              Shared by devs on X and Bluesky, covering discovery, planning, and review.
             </p>
             <p v-if="featuredCollections.length" class="data-label mt-3">
               {{ featuredCollections.length }} {{ featuredCollections.length === 1 ? 'collection' : 'collections' }} · {{ featuredSkillTotal }} {{ featuredSkillTotal === 1 ? 'skill' : 'skills' }}
@@ -671,7 +678,7 @@ function recentUpdateDescription(item: RecentUpdateCard): string {
         <div class="home-featured-heading">
           <div class="min-w-0">
             <h2 id="community-heading" class="home-featured-title text-balance">
-              Curators you can follow.
+              Curators you can watch.
             </h2>
             <p class="mt-4 max-w-xl text-base leading-relaxed text-muted text-pretty">
               <template v-if="communityTotal">
@@ -1041,16 +1048,24 @@ function recentUpdateDescription(item: RecentUpdateCard): string {
         <div class="home-publish-panel">
           <div>
             <h2 id="publish-heading" class="home-section-title home-publish-title text-balance">
-              Got a setup you keep reusing?
+              Author a Skill you own
             </h2>
             <p class="home-publish-summary mt-4">
-              skilld author starts a draft. You edit, own, and publish it in your repository, or bundle skills into a collection.
+              Run the skilld-maintained generate-package-skill Skill to draft a Skill for a package you maintain. Edit it, commit it to your repository, and skilld lists it with your name.
+            </p>
+            <p class="mt-4 text-sm">
+              <InstallCommand
+                id="publish-run-command"
+                :command="authoringRunCommand"
+                wrap
+                tabindex="0"
+              />
             </p>
           </div>
           <div class="home-publish-actions">
             <UButton
               to="/learn/author-npm-package-skills"
-              label="Bootstrap a package draft"
+              label="Read the authoring guide"
               color="neutral"
               variant="outline"
               trailing-icon="i-lucide-arrow-right"
diff --git a/layers/identity/app/pages/me/index.vue b/layers/identity/app/pages/me/index.vue
index 8d9c8bb9..f04d9525 100644
--- a/layers/identity/app/pages/me/index.vue
+++ b/layers/identity/app/pages/me/index.vue
@@ -143,7 +143,7 @@ onMounted(() => {
   if (route.query.welcome === '1') {
     toast.add({
       title: 'You\'re all set',
-      description: 'We\'ll let you know when watched repos update.',
+      description: 'Watched repos send a digest when they change.',
       color: 'success',
       icon: 'i-lucide-check-circle',
     })
@@ -399,7 +399,7 @@ function fmtDate(ts: number | null | undefined): string {
             {{ watchedRepositoryCount }} {{ watchedRepositoryCount === 1 ? 'repository supports' : 'repositories support' }} your skill updates.
           </p>
           <p class="mt-2 text-xs leading-relaxed text-muted">
-            Last GitHub sync: {{ fmtDate(me?.stars_synced_at) }}
+            Last GitHub import: {{ fmtDate(me?.stars_synced_at) }}
           </p>
           <UButton
             :loading="syncMutation.pending.value"
@@ -407,7 +407,7 @@ function fmtDate(ts: number | null | undefined): string {
             color="neutral"
             variant="outline"
             icon="i-lucide-refresh-cw"
-            label="Sync GitHub stars"
+            label="Import stars again"
             @click="sync"
           />
 
diff --git a/layers/identity/app/pages/onboarding/discover.vue b/layers/identity/app/pages/onboarding/discover.vue
index 0fc48fab..b66e8577 100644
--- a/layers/identity/app/pages/onboarding/discover.vue
+++ b/layers/identity/app/pages/onboarding/discover.vue
@@ -119,14 +119,14 @@ useSeoMeta({ title: 'Discover skills', robots: 'noindex' })
         color="neutral"
         variant="outline"
         icon="i-lucide-refresh-cw"
-        :label="data?.syncedAt ? 'Re-sync stars' : 'Sync stars'"
+        :label="data?.syncedAt ? 'Import stars again' : 'Import stars'"
         @click="syncStars"
       />
       <span v-if="syncing && syncProgress" class="text-xs text-muted">
         Page {{ syncProgress.page || '…' }} · {{ syncProgress.total }} repos cached · {{ syncProgress.matched }} match the registry
       </span>
       <span v-else-if="data?.syncedAt" class="text-xs text-muted">
-        Last synced {{ new Date(data.syncedAt * 1000).toLocaleString() }}
+        Last GitHub import {{ new Date(data.syncedAt * 1000).toLocaleString() }}
       </span>
     </div>
 
@@ -139,7 +139,7 @@ useSeoMeta({ title: 'Discover skills', robots: 'noindex' })
     </div>
     <div v-else-if="!skillItems.length" class="mt-6 rounded-lg border border-default p-6 text-sm text-muted">
       <template v-if="!data?.syncedAt">
-        We haven't checked your stars yet. Click <strong>Sync stars</strong> above, or
+        No star import yet. Click <strong>Import stars</strong> above, or
       </template>
       <template v-else>
         None of your starred repos with "skill" in the name are in the registry yet.
diff --git a/layers/marketing/app/components/FrameworkSkillsDirectory.vue b/layers/marketing/app/components/FrameworkSkillsDirectory.vue
index dc866d4f..96e75b17 100644
--- a/layers/marketing/app/components/FrameworkSkillsDirectory.vue
+++ b/layers/marketing/app/components/FrameworkSkillsDirectory.vue
@@ -232,7 +232,7 @@ function showMore() {
         </section>
 
         <p class="mt-8 text-xs text-muted">
-          Synced {{ syncedAgo }}
+          Checked GitHub {{ syncedAgo }}
         </p>
       </template>
     </div>
diff --git a/layers/marketing/app/pages/skills/[cluster].vue b/layers/marketing/app/pages/skills/[cluster].vue
index 0ac88e44..309ccd52 100644
--- a/layers/marketing/app/pages/skills/[cluster].vue
+++ b/layers/marketing/app/pages/skills/[cluster].vue
@@ -309,7 +309,7 @@ defineOgImage('Page.takumi', {
             Browse the rest.
           </h2>
           <p class="mt-3 max-w-2xl text-base leading-relaxed text-muted">
-            These all target the same kind of work. We show install counts for context.
+            These all target the same kind of work.
           </p>
         </div>
         <p class="data-label">
diff --git a/layers/marketing/app/pages/skills/best.vue b/layers/marketing/app/pages/skills/best.vue
index d764ff25..ff4289a0 100644
--- a/layers/marketing/app/pages/skills/best.vue
+++ b/layers/marketing/app/pages/skills/best.vue
@@ -30,7 +30,7 @@ const ownerCount = computed(() => new Set(skills.value.map(s => s.owner)).size)
 // admission, resolves to a readable SKILL.md in its author's repo, and holds
 // official or trusted-curator standing. The page leads with those criteria
 // rather than asserting a ranking and hoping.
-const title = 'Best Agent Skills, Reviewed and Ranked'
+const title = 'Skills worth installing, reviewed'
 const description = computed(() =>
   `${total.value} agent skills that passed review, one per author, each from a maintainer you can name. Works with Claude Code, Cursor, and Codex. Read the SKILL.md in the author's own repo before you install.`,
 )
diff --git a/layers/marketing/app/pages/skills/trending.vue b/layers/marketing/app/pages/skills/trending.vue
index d7f66ba0..ea5db71d 100644
--- a/layers/marketing/app/pages/skills/trending.vue
+++ b/layers/marketing/app/pages/skills/trending.vue
@@ -240,7 +240,7 @@ const boardMeta = computed(() => {
   if (leaderboard.value) {
     const parts = [`${board.value.length} of ${leaderboard.value.total} reviewed repos`]
     if (starsSyncedOn.value)
-      parts.push(`stars synced ${starsSyncedOn.value}`)
+      parts.push(`stars checked ${starsSyncedOn.value}`)
     return parts.join(' · ')
   }
   const parts = [`${board.value.length} skills`]
diff --git a/layers/marketing/content/learn/author-npm-package-skills.md b/layers/marketing/content/learn/author-npm-package-skills.md
index 541a9028..be769732 100644
--- a/layers/marketing/content/learn/author-npm-package-skills.md
+++ b/layers/marketing/content/learn/author-npm-package-skills.md
@@ -1,56 +1,58 @@
 ---
-title: Bootstrap an agent skill for your npm package
-description: Start a SKILL.md draft from package docs, then edit, own, and publish it in your repository.
+title: Author an agent skill for your npm package
+description: Run the skilld-maintained generate-package-skill Skill to draft a SKILL.md, then edit, commit, and own it in your repository.
 relatedPages:
-  - path: /skills/guide
-    title: Skills guide
+  - path: /skills/best
+    title: Skills worth installing
   - path: /skills
     title: Browse skills
 createdAt: 2026-05-13
-updatedAt: 2026-08-04
+updatedAt: 2026-09-01
 ---
 
-**TL;DR.** `skilld author package` creates a starting draft from your package documentation. You review the draft, rewrite it where needed, and publish it from your own repository. Skilld provides the authoring aid. You edit and own the published skill.
+**TL;DR.** The skilld CLI never writes a skill. The skilld project maintains a visible Skill named `generate-package-skill`. Run it with `skilld run`, and your agent drafts a SKILL.md for the package you maintain. You edit the draft, commit it to your repository, and skilld lists it with your name.
 
-The command is for package maintainers who want a useful first pass without starting from an empty file. It does not publish a skill, claim authorship, or place the file in a skilld-owned registry. [GitHub](https://github.com) remains the source of record.
+This guide is for package maintainers who want a useful first pass without starting from an empty file. The Skill does not publish anything, claim authorship, or place the file in a skilld-owned registry. [GitHub](https://github.com) remains the source of record.
 
-## Start the draft
+## Run the authoring Skill
 
-Run the command inside the package you maintain:
+Open your agent inside the package you maintain, then give it this command:
 
 ```bash
 cd path/to/your-package
-npx skilld author package
+npx skilld@beta run skilld:skilld-dev/skilld/generate-package-skill
 ```
 
-The command reads package material and writes a draft to `skills/<name>/SKILL.md`. It can also add the `skills` directory to the package `files` list.
+`skilld run` prints the Skill and installs nothing. Your agent reads the instructions and follows them. Nothing lands in your repository until the agent writes the draft, and you review every file before you commit.
 
-The draft is a working document. Read every section before committing it. Remove claims you cannot support, add the judgment your users need, and make sure the instructions match the current release.
+The Skill source is public. Read [generate-package-skill on GitHub](https://github.com/skilld-dev/skilld/tree/main/skills/generate-package-skill) before you run it.
 
-## What the command reads
+## What the Skill asks your agent to do
 
-The source cascade is deterministic:
+The instructions tell the agent to research before it writes:
 
-1. `docs/` in the package directory, including Markdown and MDX files.
-2. `docs/` or `docs/content/` at the monorepo root.
-3. `llms.txt` in the package, then the monorepo root.
-4. `README.md` in the package, then the monorepo root.
-5. `CHANGELOG.md`, cached separately when present.
+1. Record the exact installed package version.
+2. Read the package manifest and every exported entry point.
+3. Read public type entry points and their source definitions.
+4. Read current official documentation and runnable examples.
+5. Check release notes and migration guides for the exact version.
+6. Prefer public exports over internal files.
+7. Record advice only when the source or official documentation proves it.
 
-With an authenticated GitHub CLI, the command can also collect recent issues and discussions as reference material. Those sources help expose recurring problems. They do not replace maintainer review.
+The agent writes one directory named after the Skill. The directory contains `SKILL.md`, with detailed material in `references/` and reusable commands in `scripts/` when execution adds value.
 
 ## What the draft contains
 
-The starting draft can include:
+A starting draft can include:
 
-- API changes drawn from version history.
-- Practices and common problems drawn from documentation and issues.
-- A custom section defined by your prompt.
+- Version-specific API rules with a source path or documentation URL for each one.
+- Small examples for common tasks.
+- Environment and version limits.
 - Links back to the source documentation.
 
-You can choose prompt-only mode to write prompts under `.skilld/` without calling a model. In either mode, the output remains a draft until you edit and approve it.
+The output stays a draft until you edit and approve it. The Skill tells the agent to show the generated files for review and to replace an existing Skill only after you approve.
 
-## Review before publishing
+## Review before you commit
 
 Check the draft as package source code:
 
@@ -61,62 +63,38 @@ Check the draft as package source code:
 5. Follow every reference link and remove stale material.
 6. Read the final diff, then commit it under your own name.
 
-The published SKILL.md should reflect your judgment. If you would not sign off on a paragraph in your package documentation, do not ship it in the skill.
+The committed SKILL.md should reflect your judgment. If you would not sign off on a paragraph in your package documentation, do not ship it in the skill.
 
 ## Monorepos
 
-From a workspace root, select the packages that need drafts:
+Run the Skill once per package that needs a draft. Point the agent at the package directory each time, so each package receives its own `skills/<name>/` directory. Packages without a repository URL can reference the root repository URL for source links.
 
-```bash
-cd path/to/your-monorepo
-npx skilld author package
-# ◆ Which packages need a skill draft?
-# ◻ @scope/core
-# ◻ @scope/utils
-# ◻ @scope/cli
-```
-
-Each selected package receives its own `skills/<name>/` directory. Packages without a repository URL can inherit the root repository URL for reference collection.
-
-## Flags
-
-| Flag | What it does |
-|---|---|
-| `-y` | Skip prompts and use the configured draft settings. |
-| `-m <id>`{lang="html"} | Select the model used for this draft. |
-| `-o <dir>`{lang="html"} | Write the draft to a child directory of the package. |
-| `-f` | Clear cached references and fetch them again. |
-| `--debug` | Save raw model output under `logs/` for inspection. |
-
-Writing outside `skills/` with `-o` skips the package manifest change. Add the chosen path to `files` yourself if it belongs in the [npm](https://npmjs.com) tarball.
-
-## Publish from your repository
+## Commit to your repository
 
 Once the draft has passed maintainer review:
 
 1. Commit the SKILL.md to the package repository.
-2. Include the `skills` directory in the npm tarball when package distribution is useful.
+2. Include the `skills` directory in the [npm](https://npmjs.com) tarball when package distribution is useful.
 3. Publish the package or repository through your normal release process.
-4. Check the source link and install command after release.
+4. Check the source link and run command after release.
 
 Skilld can discover and link to the file after you publish it. The file remains yours. Your repository carries its history, issues, ownership, and removal path.
 
 ## What consumers run
 
-For a skill shipped with an npm package:
+Once skilld lists the skill, a developer gives their agent one command:
 
 ```bash
-npm install your-package
-npx skilld prepare
+npx skilld@beta run skilld:owner/repository/skill
 ```
 
-`skilld prepare` finds package skills and links them into supported agent directories. The skill remains an ordinary file under `node_modules`.
+The agent reads the skill for the current session and writes nothing. A developer who wants the skill in every session swaps `run` for `install`, and the files land in their repository as plain files.
 
-The same layout works with [skills-npm](https://github.com/antfu/skills-npm), so maintainers can support either installer from the files they own.
+The same layout works with [skills-npm](https://github.com/antfu/skills-npm), so maintainers can support either path from the files they own.
 
 ## Keep it current
 
-Review the skill when the package changes. Release automation may produce another draft, but a maintainer should inspect and approve the diff before publication. Version history remains useful only when the published guidance matches the code.
+Review the skill when the package changes. Run the Skill again to draft an update, then inspect and approve the diff before you commit. Version history remains useful only when the published guidance matches the code.
 
 ## Related
 
diff --git a/layers/marketing/content/learn/index.md b/layers/marketing/content/learn/index.md
index bf70fc05..5a31452f 100644
--- a/layers/marketing/content/learn/index.md
+++ b/layers/marketing/content/learn/index.md
@@ -4,8 +4,10 @@ description: Practical guides for finding, authoring, and shipping agent skills.
 ---
 
 ::card-grid
-- [Skills guide](/skills/guide)
-  What skills are and how curators assemble them.
-- [Official providers](/skills/official)
-  Package skills authored by skilld.
+- [Browse skills](/skills)
+  Skills written by maintainers in their own repositories, with the source one click away.
+- [Skills worth installing](/skills/best)
+  Reviewed skills, one per author, each from a maintainer you can name.
+- [Author a skill you own](/learn/author-npm-package-skills)
+  Draft a SKILL.md for your [npm](https://npmjs.com) package, then edit and commit it in your repository.
 ::
diff --git a/layers/mcp/shared/mcp-install-command.ts b/layers/mcp/shared/mcp-install-command.ts
index afa339d8..75517f2b 100644
--- a/layers/mcp/shared/mcp-install-command.ts
+++ b/layers/mcp/shared/mcp-install-command.ts
@@ -20,9 +20,20 @@ export function skillRunCommand(owner: string, repo: string, skill: string): str
   return `${V3_PREFIX} run skilld:${owner}/${repo}/${skill}`
 }
 
-export function repoInstallCommand(owner: string, repo: string, skill?: string): string {
-  const base = `${PREFIX} gh:${owner}/${repo}`
-  return skill ? `${base} -s ${skill}` : base
+/**
+ * The opt-in handoff for one skill. Same string the web Install tab prints, so
+ * a skill has one install spelling wherever the user meets it.
+ */
+export function skillInstallCommand(owner: string, repo: string, skill: string): string {
+  return `${V3_PREFIX} install skilld:${owner}/${repo}/${skill}`
+}
+
+/**
+ * Whole-repository install. Still v2 grammar: v3 has no selector for a
+ * repository yet.
+ */
+export function repoInstallCommand(owner: string, repo: string): string {
+  return `${PREFIX} gh:${owner}/${repo}`
 }
 
 export function curatorInstallCommand(login: string): string {
@@ -93,7 +104,7 @@ export function parseInstallRef(raw: string): InstallRef | null {
 export function installCommandFor(ref: InstallRef): string {
   switch (ref.kind) {
     case 'skill':
-      return repoInstallCommand(ref.owner, ref.repo, ref.name)
+      return skillInstallCommand(ref.owner, ref.repo, ref.name)
     case 'repo':
       return repoInstallCommand(ref.owner, ref.repo)
     case 'collection':
diff --git a/layers/mcp/shared/mcp-tools.ts b/layers/mcp/shared/mcp-tools.ts
index 95cac08c..9056c235 100644
--- a/layers/mcp/shared/mcp-tools.ts
+++ b/layers/mcp/shared/mcp-tools.ts
@@ -4,6 +4,7 @@ import {
   installCommandFor,
   parseInstallRef,
   repoInstallCommand,
+  skillInstallCommand,
   skillRunCommand,
 } from './mcp-install-command'
 
@@ -197,7 +198,7 @@ const searchSkills: McpTool = {
           official: s.official,
           url: `${SITE}${s.registryPath}`,
           runCommand: skillRunCommand(s.owner, s.repo, s.name),
-          installCommand: repoInstallCommand(s.owner, s.repo, s.name),
+          installCommand: skillInstallCommand(s.owner, s.repo, s.name),
         })),
       })
     }
@@ -250,7 +251,7 @@ const getSkill: McpTool = {
         },
         url: `${SITE}${s.registryPath}`,
         runCommand: skillRunCommand(s.owner, s.repo, s.name),
-        installCommand: repoInstallCommand(s.owner, s.repo, s.name),
+        installCommand: skillInstallCommand(s.owner, s.repo, s.name),
         provenance: {
           author: s.provenance.owner,
           sourceRepoUrl: s.githubUrl,
@@ -326,7 +327,7 @@ const getCollection: McpTool = {
           reason: truncate(s.reason, 1_000),
           url: `${SITE}${s.registryPath}`,
           runCommand: s.name ? skillRunCommand(s.owner, s.repo, s.name) : null,
-          installCommand: repoInstallCommand(s.owner, s.repo, s.name ?? undefined),
+          installCommand: s.name ? skillInstallCommand(s.owner, s.repo, s.name) : repoInstallCommand(s.owner, s.repo),
         })),
       })
     }
diff --git a/layers/registry/app/pages/gh/[owner]/index.vue b/layers/registry/app/pages/gh/[owner]/index.vue
index 5d2950c4..634003b1 100644
--- a/layers/registry/app/pages/gh/[owner]/index.vue
+++ b/layers/registry/app/pages/gh/[owner]/index.vue
@@ -119,14 +119,14 @@ useSeoMeta({
     if (!data.value)
       return `Agent skills published by @${ownerParam.value} on skilld.`
     const tagPart = fingerprint.value ? ` ${fingerprint.value}.` : ''
-    const verb = isUser.value ? 'curated by' : 'published by'
+    const verb = isUser.value ? 'written by' : 'published by'
     return `${data.value.totalSkills} agent ${data.value.totalSkills === 1 ? 'skill' : 'skills'} ${verb} ${data.value.displayName} on skilld.${tagPart}`
   },
   ogTitle: () => data.value?.displayName ? `${data.value.displayName} on skilld` : `@${ownerParam.value} on skilld`,
   ogDescription: () => {
     if (!data.value)
       return ''
-    const verb = isUser.value ? 'curated by' : 'published by'
+    const verb = isUser.value ? 'written by' : 'published by'
     return `${data.value.totalSkills} agent skills ${verb} ${data.value.displayName}.`
   },
   ogUrl: canonicalUrl,
@@ -175,7 +175,7 @@ useSchemaOrg(computed(() => {
         'contentUrl': d.avatar,
       },
       sameAs,
-      'description': d.description ?? `Agent skills ${isUser.value ? 'curated by' : 'published by'} ${d.displayName} on skilld.`,
+      'description': d.description ?? `Agent skills ${isUser.value ? 'written by' : 'published by'} ${d.displayName} on skilld.`,
     },
     {
       '@type': 'CollectionPage' as const,
@@ -337,14 +337,14 @@ useSchemaOrg(computed(() => {
             <span
               v-if="syncStale"
               class="data-label inline-flex items-center gap-1 text-amber-500"
-              :title="data.lastSyncedAt ? `Last synced ${new Date(data.lastSyncedAt * 1000).toLocaleString()}` : 'Never synced'"
+              :title="data.lastSyncedAt ? `Last GitHub check ${new Date(data.lastSyncedAt * 1000).toLocaleString()}` : 'No GitHub check yet'"
             >
               <UIcon
                 name="i-lucide-clock-alert"
                 class="size-3"
                 aria-hidden="true"
               />
-              <span v-if="!data.lastSyncedAt">Sync pending</span>
+              <span v-if="!data.lastSyncedAt">GitHub check pending</span>
               <span v-else>
                 Synced
                 <NuxtTime
@@ -401,7 +401,7 @@ useSchemaOrg(computed(() => {
             </p>
             <div class="mt-1 max-w-xl space-y-1 text-sm leading-relaxed text-muted">
               <p>Sign in as @{{ data.owner }} with GitHub.</p>
-              <p>Your indexed skills will appear in Community.</p>
+              <p>Your indexed skills will appear on your curator profile.</p>
               <p>skilld will also check your public repositories for other <code>SKILL.md</code> files.</p>
             </div>
             <UButton
@@ -428,13 +428,13 @@ useSchemaOrg(computed(() => {
               This is your skill profile
             </p>
             <div class="mt-1 max-w-xl space-y-1 text-sm leading-relaxed text-muted">
-              <p>Your indexed skills appear on your Community profile.</p>
+              <p>Your indexed skills appear on your curator profile.</p>
               <p>skilld also checks your public repositories for other <code>SKILL.md</code> files.</p>
             </div>
             <UButton
               :to="`/@${data.owner}`"
               icon="i-lucide-user-round"
-              label="View Community profile"
+              label="View curator profile"
               color="neutral"
               variant="outline"
               size="md"
@@ -533,7 +533,7 @@ useSchemaOrg(computed(() => {
 
       <p class="mx-auto max-w-5xl px-4 sm:px-6 pb-8 text-xs text-muted">
         <span class="sr-only">{{ headline }}.</span>
-        Synced <span data-allow-mismatch="text">{{ syncedAgo }}</span>
+        Checked GitHub <span data-allow-mismatch="text">{{ syncedAgo }}</span>
       </p>
     </template>
   </div>
diff --git a/layers/registry/server/data/clusters.ts b/layers/registry/server/data/clusters.ts
index 418081ed..761e3481 100644
--- a/layers/registry/server/data/clusters.ts
+++ b/layers/registry/server/data/clusters.ts
@@ -206,7 +206,7 @@ export const CLUSTERS: Cluster[] = [
     slug: 'code-review',
     label: 'Review and refactoring',
     icon: 'i-lucide-eye',
-    userVoice: 'You read other people\'s code and reshape it without breaking it.',
+    userVoice: 'You read other devs\' code and reshape it without breaking it.',
     seoTitle: 'Agent Skills for Code Review',
     seoDescription:
       'Code review and refactoring skills for AI agents. Turn review comments, bot findings, and production issues into fixed code, with skills written by maintainers who review for a living.',
diff --git a/test/unit/compact-page-header-ui.test.ts b/test/unit/compact-page-header-ui.test.ts
index 4fb9490f..0f4de45c 100644
--- a/test/unit/compact-page-header-ui.test.ts
+++ b/test/unit/compact-page-header-ui.test.ts
@@ -5,7 +5,7 @@ import CompactPageHeader from '../../app/components/CompactPageHeader.vue'
 
 const baseProps = {
   title: 'Community',
-  description: 'Curators you can follow.',
+  description: 'Curators you can watch.',
   headingId: 'community-heading',
 }
 
@@ -16,7 +16,7 @@ describe('compactPageHeader', () => {
     const heading = wrapper.get('h1')
     expect(heading.text()).toBe('Community')
     expect(heading.attributes('id')).toBe('community-heading')
-    expect(wrapper.get('header').text()).toContain('Curators you can follow.')
+    expect(wrapper.get('header').text()).toContain('Curators you can watch.')
 
     wrapper.unmount()
   })
diff --git a/test/unit/mcp-discovery.test.ts b/test/unit/mcp-discovery.test.ts
index a466b4a3..80974a5b 100644
--- a/test/unit/mcp-discovery.test.ts
+++ b/test/unit/mcp-discovery.test.ts
@@ -89,7 +89,7 @@ describe('search_skills', () => {
       name: 'nuxt-seo',
       official: true,
       url: 'https://skilld.dev/gh/nuxt/nuxt',
-      installCommand: 'npx skilld add gh:nuxt/nuxt -s nuxt-seo',
+      installCommand: 'npx skilld@beta install skilld:nuxt/nuxt/nuxt-seo',
     })
     expect(data.results[0].description.length).toBe(500)
   })
@@ -153,7 +153,7 @@ describe('get_skill', () => {
 
     expect(fetchApi).toHaveBeenCalledWith('/api/skills/nuxt/nuxt/nuxt-seo', { signal: undefined })
     expect(data.runCommand).toBe('npx skilld@beta run skilld:nuxt/nuxt/nuxt-seo')
-    expect(data.installCommand).toBe('npx skilld add gh:nuxt/nuxt -s nuxt-seo')
+    expect(data.installCommand).toBe('npx skilld@beta install skilld:nuxt/nuxt/nuxt-seo')
     expect(data.provenance).toMatchObject({
       author: 'nuxt',
       sourceRepoUrl: 'https://github.com/nuxt/nuxt',
@@ -233,7 +233,7 @@ describe('install_command', () => {
   it.each([
     ['gh:nuxt/nuxt', 'npx skilld add gh:nuxt/nuxt'],
     ['nuxt/nuxt', 'npx skilld add gh:nuxt/nuxt'],
-    ['anthropics/skills/skill-creator', 'npx skilld add gh:anthropics/skills -s skill-creator'],
+    ['anthropics/skills/skill-creator', 'npx skilld@beta install skilld:anthropics/skills/skill-creator'],
     ['@harlan-zw', 'npx skilld add @harlan-zw'],
     ['@harlan-zw/nuxt-stack', 'npx skilld add @harlan-zw/nuxt-stack'],
     ['npm:@scope/pkg', 'npx skilld add npm:@scope/pkg'],
diff --git a/test/unit/me-watchlist.test.ts b/test/unit/me-watchlist.test.ts
index 788f7776..b0037ad6 100644
--- a/test/unit/me-watchlist.test.ts
+++ b/test/unit/me-watchlist.test.ts
@@ -244,11 +244,11 @@ describe('account skill watchlist', () => {
 
   it('refreshes the visible account timestamp after syncing GitHub stars', async () => {
     const wrapper = await mountPage()
-    const before = paragraphWithText(wrapper, 'Last GitHub sync:').text()
+    const before = paragraphWithText(wrapper, 'Last GitHub import:').text()
 
-    await buttonWithText(wrapper, 'Sync GitHub stars').trigger('click')
+    await buttonWithText(wrapper, 'Import stars again').trigger('click')
     await flushPromises()
-    const after = paragraphWithText(wrapper, 'Last GitHub sync:').text()
+    const after = paragraphWithText(wrapper, 'Last GitHub import:').text()
 
     expect(after).not.toBe(before)
   })