konstruct 0.1.0 → 0.1.1

package/README.md

@@ -2,6 +2,11 @@
 
 Package manager for AI agent skills. Manages the lifecycle of skill directories — discovery, installation, updating, and removal — across one or more AI agent tool directories.
 
+## Add Skills
+```bash
+npx konstruct add owner/repo
+```
+
 ## Install
 
 ```bash
@@ -15,7 +20,10 @@ npm install -g konstruct
 konstruct init
 
 # Add a skill from GitHub
-konstruct add github:anthropics/skills/skills/canvas-design#main
+konstruct add anthropics/skills
+
+# Add a specific skill from repo
+konstruct add anthropics/skills --skill skill-creator
 
 # Install all skills from skills.json
 konstruct install
@@ -27,6 +35,117 @@ konstruct update
 konstruct list
 ```
 
+## Features
+
+### Declarative Manifest
+
+Every project gets a `skills.json` that declares exactly which skills it needs and where they come from. Run `konstruct install` on any machine and get the same setup — no manual steps.
+
+```json
+{
+  "name": "my-project",
+  "version": "1.0.0",
+  "skills": {
+    "canvas-design": {
+      "source": "anthropic/skills/canvas-design#v1.0"
+    },
+    "data-analytics": {
+      "source": "github:company/analytics-repo/skills/analytics#main"
+    }
+  },
+  "userSkills": {
+    "my-local-skill": {
+      "source": "file:./local-skills/my-skill"
+    }
+  }
+}
+```
+
+
+### Default Agents
+
+Configure which agents receive skills so you don't have to specify them every time. Set defaults at the project or global level with `konstruct defaults`, or let them resolve automatically:
+
+1. Project config (`./konstruct.config.json`) agents
+2. Global config (`~/.konstruct/konstruct.config.json`) default agents
+3. Fallback: `claude`
+
+```json
+{
+  "version": 1,
+  "agents": ["claude", "cursor"],
+  "global": {
+    "defaultAgents": ["claude"]
+  }
+}
+```
+
+### Private Skils
+
+Konstruct can install skills from private repositories as long as your local machine is authenticated. HTTPS uses your existing git credentials (e.g. `gh auth login`), or you can use SSH:
+
+```bash
+# Private repo over HTTPS (uses your local git credentials)
+konstruct add github:my-org/private-skills
+
+# Private repo over SSH
+konstruct add github:my-org/private-skills --ssh
+```
+
+### Global and Project Configuration
+
+Konstruct operates at two scopes. Project-level config lives in your repo and tracks which agents that project uses. Global config lives at `~/.konstruct/` and provides defaults for all projects.
+
+```bash
+# Project scope (default)
+konstruct init
+konstruct add anthropic/skills/canvas-design#main
+
+# Global scope
+konstruct init -g
+konstruct add -g anthropic/skills/canvas-design#main
+```
+
+Every command supports `-g, --global` to switch between scopes.
+
+### Custom Install Paths
+
+Override where a skill gets installed with `--path`. The path is saved in the manifest so subsequent `konstruct install` and `konstruct update` calls respect it.
+
+```bash
+konstruct add github:org/repo --path /opt/shared-skills
+```
+
+```json
+{
+  "skills": {
+    "repo": {
+      "source": "github:org/repo",
+      "path": "/opt/shared-skills"
+    }
+  }
+}
+```
+
+### Local Skills
+
+Add skills from your local filesystem with `--user`. These are kept in a separate `userSkills` section of the manifest and are never auto-updated, making them ideal for private or in-development skills.
+
+```bash
+konstruct add file:./my-private-skill --user
+```
+
+Skills are separated into two categories:
+
+|  | Installed Skills | User Skills |
+|---|---|---|
+| **Sources** | GitHub, GitLab, any git URL | Local filesystem only |
+| **Updates** | Auto-updated via `konstruct update` | Never auto-updated |
+| **Use case** | Shared, versioned skills | Private, local, or experimental |
+| **Flag** | (default) | `--user` |
+
+Both types are installed when running `konstruct install`, but `konstruct update` only touches git-based skills.
+
 ## Commands
 
 | Command | Description |
@@ -39,24 +158,14 @@ konstruct list
 | `konstruct list` | List all skills in the current manifest |
 | `konstruct defaults` | View and update default agent preferences |
 
-### Global mode
-
-All commands support `-g, --global` to operate on `~/.konstruct/` instead of the current directory.
-
-```bash
-konstruct init -g          # Set up global config
-konstruct add -g <source>  # Install globally
-konstruct list -g          # List global skills
-```
-
 ### Options
 
 - `-g, --global` — Use global `~/.konstruct/` directory
 - `-s, --ssh` — Use SSH for git cloning (default: HTTPS with auto-retry)
-- `--user` — Add as a userSkill (local, never auto-updated)
+- `--user` — Add as a user skill (local, never auto-updated)
 - `--path <path>` — Custom installation path
 
-## Source formats
+## Source Formats
 
 | Format | Example |
 |---|---|
@@ -66,7 +175,7 @@ konstruct list -g          # List global skills
 | Local file | `file:./relative/path` |
 | Bare shorthand | `owner/repo` (defaults to GitHub) |
 
-## Supported agents
+## Supported Agents
 
 Konstruct installs skills into the appropriate directory for each agent:
 

package/dist/{chunk-MYTZHNE6.js → chunk-DVITKAMZ.js}

@@ -458,7 +458,7 @@ function Banner() {
 |_|\\_\\___/|_| |_|___/  \\__||_|    \\__,_|\\___|\\__|`.trimStart();
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
     /* @__PURE__ */ jsx(Text, { color: "cyan", bold: true, children: art }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  Package manager for AI agent skills" })
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  AI Skills Package manager for teams" })
   ] });
 }
 

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   readManifest,
   removeSkillFromManifest,
   writeConfig
-} from "./chunk-MYTZHNE6.js";
+} from "./chunk-DVITKAMZ.js";
 
 // src/cli/index.ts
 import { Command } from "commander";
@@ -480,7 +480,7 @@ function AddApp({ source, options: initialOptions }) {
       opts.global = true;
       setOptions(opts);
     } else {
-      const { initCommand: initCommand2 } = await import("./init-CJ7EZ75L.js");
+      const { initCommand: initCommand2 } = await import("./init-SHM34JBM.js");
       await initCommand2();
     }
     if (parsed) await startInstall(parsed, opts);
@@ -531,6 +531,19 @@ function AddApp({ source, options: initialOptions }) {
       finish();
       return;
     }
+    if (opts.skill) {
+      const notFound = opts.skill.filter((s) => !discovered.some((d) => d.name === s));
+      if (notFound.length > 0) {
+        addMsg("error", `Skill(s) not found: ${notFound.join(", ")}`);
+        setSpinnerLabel("");
+        setSkills(discovered);
+        setPhase("selecting");
+        return;
+      }
+      const picks = discovered.filter((d) => opts.skill.includes(d.name));
+      await installPicks(parsedSource, opts, picks, discovered);
+      return;
+    }
     if (discovered.length === 1) {
       addMsg("info", `Found 1 skill: "${discovered[0].name}"`);
       await installPicks(parsedSource, opts, [discovered[0]], discovered);
@@ -1186,7 +1199,7 @@ var program = new Command();
 program.name("konstruct").description("Package manager for AI agent skills").version(getVersion());
 program.command("init").description("Initialize skills.json and konstruct.config.json").option("-g, --global", "Initialize global configuration (~/.konstruct/) instead of project-local").action(initCommand);
 program.command("install").description("Install all skills from skills.json").option("-g, --global", "Install globally (~/) instead of project-local").option("-s, --ssh", "Use SSH for cloning (default: HTTPS with auto-retry on auth failure)").action(installCommand);
-program.command("add <source>").description("Add a skill from a git or local source").option("-g, --global", "Install globally").option("--user", "Add as a userSkill (local, never auto-updated)").option("--path <path>", "Custom installation path").option("-s, --ssh", "Use SSH for cloning (default: HTTPS with auto-retry on auth failure)").action(addCommand);
+program.command("add <source>").description("Add a skill from a git or local source").option("-g, --global", "Install globally").option("--user", "Add as a userSkill (local, never auto-updated)").option("--path <path>", "Custom installation path").option("-s, --ssh", "Use SSH for cloning (default: HTTPS with auto-retry on auth failure)").option("--skill <names...>", "Install specific skill(s) by name, skipping the selection prompt").action(addCommand);
 program.command("remove <names...>").description("Remove one or more skills by name").option("-g, --global", "Remove from global (~/) directories instead of project-local").action(removeCommand);
 program.command("list").description("List all skills in the current manifest").option("-g, --global", "List skills from the global manifest instead of project-local").action(listCommand);
 program.command("update").description("Re-install git skills at their manifest refs (skips userSkills)").option("-g, --global", "Update in global (~/) directories instead of project-local").option("-s, --ssh", "Use SSH for cloning (default: HTTPS with auto-retry on auth failure)").action(updateCommand);

package/dist/{init-CJ7EZ75L.js → init-SHM34JBM.js}

@@ -1,6 +1,6 @@
 import {
   initCommand
-} from "./chunk-MYTZHNE6.js";
+} from "./chunk-DVITKAMZ.js";
 export {
   initCommand
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "konstruct",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Package manager for AI agent skills",
   "type": "module",
   "license": "MIT",
@@ -38,7 +38,40 @@
     "prepublishOnly": "npm run build"
   },
   "release": {
-    "branches": ["main"]
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "releaseRules": [
+            {
+              "type": "feat",
+              "release": "patch"
+            },
+            {
+              "breaking": true,
+              "release": "minor"
+            }
+          ]
+        }
+      ],
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      "@semantic-release/changelog",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "CHANGELOG.md"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]"
+        }
+      ],
+      "@semantic-release/github"
+    ]
   },
   "dependencies": {
     "commander": "^13.0.0",
@@ -49,6 +82,10 @@
     "simple-git": "^3.27.0"
   },
   "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^13.1.4",
     "@types/node": "^22.0.0",
     "@types/react": "^19.2.13",
     "semantic-release": "^24.2.9",
@@ -57,6 +94,11 @@
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   },
+  "overrides": {
+    "semantic-release": {
+      "@semantic-release/npm": "$@semantic-release/npm"
+    }
+  },
   "engines": {
     "node": ">=18"
   }