release: publish as @zakelfassi/skdd on npm

The unscoped 'skdd' name is blocked by npm's similarity filter
(too close to add/sade/send/spdy). Scope under @zakelfassi so
the package can publish. The bin command is still 'skdd' — only
the install target changes.

- cli/package.json: rename to @zakelfassi/skdd + publishConfig
- README.md: shields.io badges point at the scoped package
- All install docs: pnpm dlx skdd → pnpm dlx @zakelfassi/skdd
- .colony.json: cli.package → @zakelfassi/skdd

v0.3.0 published manually from local. CI publish workflow needs
a token that can write under the scope; tracked as follow-up.

Author: zakelfassi

.colony.json

@@ -40,7 +40,7 @@
     }
   ],
   "cli": {
-    "package": "skdd",
+    "package": "@zakelfassi/skdd",
     "path": "cli"
   },
   "plugins": [

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -88,7 +88,7 @@ body:
       description: Minimal steps, starting from a clean directory if possible.
       placeholder: |
         1. mkdir /tmp/repro && cd /tmp/repro
-        2. pnpm dlx skdd init --harness=claude
+        2. pnpm dlx @zakelfassi/skdd init --harness=claude
         3. ...
       render: shell
     validations:

README.md

@@ -5,8 +5,8 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/skdd"><img alt="npm version" src="https://img.shields.io/npm/v/skdd?color=0ea5e9&label=skdd&logo=npm"></a>
-  <a href="https://www.npmjs.com/package/skdd"><img alt="downloads" src="https://img.shields.io/npm/dw/skdd?color=0ea5e9&label=downloads&logo=npm"></a>
+  <a href="https://www.npmjs.com/package/@zakelfassi/skdd"><img alt="npm version" src="https://img.shields.io/npm/v/@zakelfassi/skdd?color=0ea5e9&label=%40zakelfassi%2Fskdd&logo=npm"></a>
+  <a href="https://www.npmjs.com/package/@zakelfassi/skdd"><img alt="downloads" src="https://img.shields.io/npm/dw/@zakelfassi/skdd?color=0ea5e9&label=downloads&logo=npm"></a>
   <a href="https://github.com/zakelfassi/skills-driven-development/actions"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/zakelfassi/skills-driven-development/validate-skills.yml?branch=main&label=CI&logo=github"></a>
   <a href="./LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-0ea5e9"></a>
   <a href="https://github.com/zakelfassi/skills-driven-development/stargazers"><img alt="stars" src="https://img.shields.io/github/stars/zakelfassi/skills-driven-development?color=f59e0b&label=stars&logo=github"></a>
@@ -80,7 +80,7 @@ Run this from the root of **your own project** (not this repo):
 
 ```bash
 # With the CLI (recommended)
-pnpm dlx skdd init --harness=claude
+pnpm dlx @zakelfassi/skdd init --harness=claude
 ```
 
 That one command creates `skills/skillforge/SKILL.md` (a stub of the meta-skill), `.skills-registry.md` at the project root, a `## Skills` block appended to `CLAUDE.md`, and a `.claude/skills` symlink → `../skills` so Claude Code discovers the colony at its conventional path. A `.skdd-sync.json` state file tracks the mirror so `skdd link` can reconcile drift later.

cli/README.md

@@ -5,11 +5,11 @@
 ## Install
 
 ```bash
-pnpm add -D skdd
+pnpm add -D @zakelfassi/skdd
 # or globally
-pnpm add -g skdd
+pnpm add -g @zakelfassi/skdd
 # or one-shot
-pnpm dlx skdd init --harness=claude
+pnpm dlx @zakelfassi/skdd init --harness=claude
 ```
 
 This repo uses pnpm exclusively — do not use npm or yarn.

cli/package.json

@@ -1,6 +1,9 @@
 {
-  "name": "skdd",
+  "name": "@zakelfassi/skdd",
   "version": "0.3.0",
+  "publishConfig": {
+    "access": "public"
+  },
   "description": "Skills-Driven Development CLI — validate, init, forge, list, link, doctor, import, and sync SkDD skill colonies. Manages the canonical skills/ + harness mirror pattern and consolidates duplicate skills across harness mirrors.",
   "type": "module",
   "bin": {

docs/configuration.md

@@ -51,7 +51,7 @@ If you only use one harness, the mirror is invisible — you'll never notice it.
 
 ```bash
 # With the CLI (recommended; pnpm required per repo policy)
-pnpm dlx skdd init --harness=claude      # or codex / cursor / copilot / gemini / opencode / goose / amp / auto
+pnpm dlx @zakelfassi/skdd init --harness=claude      # or codex / cursor / copilot / gemini / opencode / goose / amp / auto
 ```
 
 That creates `skills/skillforge/SKILL.md`, `.skills-registry.md`, the harness-specific instruction file with a `## Skills` block appended, a `.<harness>/skills` mirror pointing at `../skills`, and a `.skdd-sync.json` state file. Re-run `skdd link` any time to reconcile drift or add mirrors for additional harnesses.
@@ -80,7 +80,7 @@ Every section below tells you **which instruction file to edit**, **what to past
 - **Mirror**: `.claude/skills/` → `../skills`
 - **Scopes**: personal (`~/.claude/skills/`), project (`.claude/skills/` — SkDD uses this), plugin, enterprise
 
-Install: `pnpm dlx skdd init --harness=claude`
+Install: `pnpm dlx @zakelfassi/skdd init --harness=claude`
 
 Skills block (auto-written by `skdd init`):
 
@@ -110,7 +110,7 @@ See [`docs/integrations/claude-code.md`](integrations/claude-code.md) for the fu
 - **Mirror**: `.codex/skills/` → `../skills`
 - **Scopes**: user (`~/.codex/skills/`), project (`.codex/skills/`)
 
-Install: `pnpm dlx skdd init --harness=codex`
+Install: `pnpm dlx @zakelfassi/skdd init --harness=codex`
 
 Paste the same skills block as Claude Code, but swap `.claude/skills` → `.codex/skills` in the text.
 
@@ -123,7 +123,7 @@ Verify with the three-question check (`What skills do we have?` → `Forge …`
 - **Instruction file**: `.cursor/rules/skills.mdc` (Cursor's agent-mode rules format)
 - **Mirror**: `.cursor/skills/` → `../skills`
 
-Install: `pnpm dlx skdd init --harness=cursor`
+Install: `pnpm dlx @zakelfassi/skdd init --harness=cursor`
 
 Skills block (the rules file needs `alwaysApply: true` frontmatter so every agent conversation picks it up):
 
@@ -146,7 +146,7 @@ Verify in Cursor's agent chat. Full details at [`docs/integrations/cursor.md`](i
 - **Mirror**: `.github/skills/` → `../skills`
 - **Applies to**: Copilot agent surfaces (Chat, Workspace, Coding Agent). Inline ghost-text completions don't see skills.
 
-Install: `pnpm dlx skdd init --harness=copilot`
+Install: `pnpm dlx @zakelfassi/skdd init --harness=copilot`
 
 Verify in Copilot Chat with `@workspace what skills are registered?`. Full details at [`docs/integrations/github-copilot.md`](integrations/github-copilot.md).
 
@@ -157,7 +157,7 @@ Verify in Copilot Chat with `@workspace what skills are registered?`. Full detai
 - **Instruction file**: `AGENTS.md`
 - **Mirror**: `.gemini/skills/` → `../skills`
 
-Install: `pnpm dlx skdd init --harness=gemini`. See [geminicli.com/docs/cli/skills/](https://geminicli.com/docs/cli/skills/) and [`docs/integrations/gemini-cli.md`](integrations/gemini-cli.md).
+Install: `pnpm dlx @zakelfassi/skdd init --harness=gemini`. See [geminicli.com/docs/cli/skills/](https://geminicli.com/docs/cli/skills/) and [`docs/integrations/gemini-cli.md`](integrations/gemini-cli.md).
 
 ---
 
@@ -166,7 +166,7 @@ Install: `pnpm dlx skdd init --harness=gemini`. See [geminicli.com/docs/cli/skil
 - **Instruction file**: `AGENTS.md`
 - **Mirror**: `.opencode/skills/` → `../skills`
 
-Install: `pnpm dlx skdd init --harness=opencode`. See [opencode.ai/docs/skills/](https://opencode.ai/docs/skills/) and [`docs/integrations/opencode.md`](integrations/opencode.md).
+Install: `pnpm dlx @zakelfassi/skdd init --harness=opencode`. See [opencode.ai/docs/skills/](https://opencode.ai/docs/skills/) and [`docs/integrations/opencode.md`](integrations/opencode.md).
 
 ---
 
@@ -175,7 +175,7 @@ Install: `pnpm dlx skdd init --harness=opencode`. See [opencode.ai/docs/skills/]
 - **Instruction file**: `AGENTS.md` (or `.goose/config.yaml` for Goose-specific settings)
 - **Mirror**: `.goose/skills/` → `../skills`
 
-Install: `pnpm dlx skdd init --harness=goose`. See [block.github.io/goose/docs/guides/context-engineering/using-skills/](https://block.github.io/goose/docs/guides/context-engineering/using-skills/) and [`docs/integrations/goose.md`](integrations/goose.md).
+Install: `pnpm dlx @zakelfassi/skdd init --harness=goose`. See [block.github.io/goose/docs/guides/context-engineering/using-skills/](https://block.github.io/goose/docs/guides/context-engineering/using-skills/) and [`docs/integrations/goose.md`](integrations/goose.md).
 
 ---
 
@@ -184,7 +184,7 @@ Install: `pnpm dlx skdd init --harness=goose`. See [block.github.io/goose/docs/g
 - **Instruction file**: `AGENTS.md`
 - **Mirror**: `.amp/skills/` → `../skills`
 
-Install: `pnpm dlx skdd init --harness=amp`. See [ampcode.com/manual#agent-skills](https://ampcode.com/manual#agent-skills) and [`docs/integrations/amp.md`](integrations/amp.md).
+Install: `pnpm dlx @zakelfassi/skdd init --harness=amp`. See [ampcode.com/manual#agent-skills](https://ampcode.com/manual#agent-skills) and [`docs/integrations/amp.md`](integrations/amp.md).
 
 ---
 

docs/integrations/amp.md

@@ -5,7 +5,7 @@
 ## Quick install
 
 ```bash
-pnpm dlx skdd init --harness=amp
+pnpm dlx @zakelfassi/skdd init --harness=amp
 ```
 
 Creates `skills/skillforge/SKILL.md` (canonical), `.skills-registry.md`, the `AGENTS.md` skills block, and `.amp/skills → ../skills` as the mirror Amp reads.

docs/integrations/claude-code.md

@@ -7,7 +7,7 @@
 Run `skdd init` from the root of **your own project** (not the SkDD repo):
 
 ```bash
-pnpm dlx skdd init --harness=claude
+pnpm dlx @zakelfassi/skdd init --harness=claude
 ```
 
 That single command:

docs/integrations/codex.md

@@ -5,7 +5,7 @@
 ## Install
 
 ```bash
-pnpm dlx skdd init --harness=codex
+pnpm dlx @zakelfassi/skdd init --harness=codex
 ```
 
 Creates `skills/skillforge/SKILL.md` (canonical) + `.skills-registry.md` + `AGENTS.md` with the skills block + `.codex/skills → ../skills` symlink + `.skdd-sync.json` state.

docs/integrations/cursor.md

@@ -5,7 +5,7 @@
 ## Install
 
 ```bash
-pnpm dlx skdd init --harness=cursor
+pnpm dlx @zakelfassi/skdd init --harness=cursor
 ```
 
 Creates `skills/skillforge/SKILL.md` (canonical) + `.skills-registry.md` + `.cursor/rules/skills.mdc` with the rules block + `.cursor/skills → ../skills` symlink + `.skdd-sync.json` state.