@penpair/core 0.1.2 → 0.1.3

package/dist/cli-main.js

@@ -44,7 +44,7 @@ Read-only:
   penpair export <shapeId> <out.png> [--page <name>] [--scale 1]
 @@INSTANCE@@Skills (the rules an AI agent follows, shipped with penpair):
   penpair skills                                       list them
-  penpair skills install [--to .skills] [--only <name>] [--force]   copy them into the project and make them discoverable
+  penpair skills install [--to <folder>] [--only <name>] [--force]   copy them into the project and make them discoverable
 Snippets (the built-in ones and the project's own, listed under "snippets" in penpair.config.json):
   penpair snippets                                     what can be run, with its parameters
   penpair snippets check                               validate the project's snippets without a connection
@@ -208,7 +208,7 @@ async function main(argv, cli) {
             local: cli.local,
             installSkills: async () => {
                 const report = await installSkills({ root });
-                console.log(`Installed ${report.installed.length} rule file(s) in .skills/ (${report.unchanged.length} already there). Add these rows to your AGENTS.md skills table:\n${report.agentsRows.join("\n")}`);
+                console.log(`Installed ${report.installed.length} rule file(s) in ${report.to}/ (${report.unchanged.length} already there). Add these rows to your AGENTS.md skills table:\n${report.agentsRows.join("\n")}`);
             },
         });
         return 0;
@@ -258,7 +258,7 @@ async function main(argv, cli) {
         const result = await init(root, { instance: values.instance, port: values.port ? Number(values.port) : undefined, gitignore: values.gitignore, external: values.external }, { local: cli.local });
         if (isExternal(result.config)) {
             console.log(`${result.createdConfig ? "created" : "kept"} penpair.config.json (external Penpot at ${result.config.profile.origin})`);
-            console.log("next: penpair connect   (takes your personal key without showing it, then waits for the editor)");
+            console.log("next: in Penpot switch on Account, Integrations, MCP Server and copy the address; open a design file and choose File, MCP Server, Connect; then run penpair connect (takes the address without showing it)");
             return 0;
         }
         console.log(`${result.createdConfig ? "created" : "kept"} penpair.config.json (instance ${result.config.instance}, Penpot ${result.config.penpotVersion}, port ${result.config.ports.frontend})`);

package/dist/skills.d.ts

@@ -23,6 +23,8 @@ export interface InstallOptions {
 /** Skills that changed name. Installing the new one leaves the old folder behind, which `installSkills` then reports. */
 export declare const renamedSkills: Record<string, string>;
 export interface InstallReport {
+    /** The folder the skills went to, relative to the root. */
+    to: string;
     installed: string[];
     unchanged: string[];
     /** Files that differ from the shipped ones and were left alone. */
@@ -37,4 +39,6 @@ export interface InstallReport {
         carriedFacts: boolean;
     }[];
 }
+/** Where the penpair skills already live in a project as real folders (not links), so a later install goes to the same place. */
+export declare function existingSkillsFolder(root: string): Promise<string | undefined>;
 export declare function installSkills(options: InstallOptions): Promise<InstallReport>;

package/dist/skills.js

@@ -46,15 +46,26 @@ export async function describeSkill(skillDirectory) {
 }
 /** Skills that changed name. Installing the new one leaves the old folder behind, which `installSkills` then reports. */
 export const renamedSkills = { "penpot-design": "penpair-design" };
+/** Where the penpair skills already live in a project as real folders (not links), so a later install goes to the same place. */
+export async function existingSkillsFolder(root) {
+    for (const folder of [".skills", ".claude/skills", ".agents/skills"]) {
+        for (const name of ["penpair-design", "penpair-setup", ...Object.keys(renamedSkills)]) {
+            const found = await lstat(path.join(root, folder, name)).catch(() => undefined);
+            if (found?.isDirectory())
+                return folder;
+        }
+    }
+    return undefined;
+}
 export async function installSkills(options) {
     const source = options.source ?? bundledSkillsDirectory();
-    const to = options.to ?? ".skills";
+    const to = options.to ?? (await existingSkillsFolder(options.root)) ?? ".skills";
     const names = await listBundledSkills(source);
     const chosen = options.only ? options.only : names;
     for (const name of chosen)
         if (!names.includes(name))
             throw new Error(`no skill named ${name}; shipped: ${names.join(", ")}`);
-    const report = { installed: [], unchanged: [], kept: [], linked: [], agentsRows: [], legacy: [] };
+    const report = { to, installed: [], unchanged: [], kept: [], linked: [], agentsRows: [], legacy: [] };
     for (const name of chosen) {
         const from = path.join(source, name);
         for (const file of await filesUnder(from)) {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Kept in its own file so that the command line and the library entry can both read it without importing each other. Equals package.json (a test checks). */
-export declare const version = "0.1.2";
+export declare const version = "0.1.3";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Kept in its own file so that the command line and the library entry can both read it without importing each other. Equals package.json (a test checks). */
-export const version = "0.1.2";
+export const version = "0.1.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penpair/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Design together. Build together. The library and engine behind penpair: connect AI agents and people to a Penpot design file, safely. Install @penpair/web or @penpair/docker for the command.",
   "license": "MIT",
   "repository": {