veryfront 0.1.854 → 0.1.856

package/esm/cli/commands/generate/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,WAkB1B,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,WAuB1B,CAAC"}

package/esm/cli/commands/generate/command-help.js

@@ -8,12 +8,17 @@ export const generateHelp = {
         "veryfront generate page about",
         "veryfront generate layout admin",
         "veryfront generate api users/[id]",
-        "veryfront generate provider auth",
+        "veryfront generate agent researcher",
+        "veryfront generate tool search-docs",
+        "veryfront generate workflow content-pipeline",
+        "veryfront generate task sync-data",
+        "veryfront generate resource docs",
+        "veryfront generate skill code-review",
         "veryfront generate integration             # Interactive wizard",
         "veryfront generate integration twilio      # With name preset",
     ],
     notes: [
-        "Types: page, layout, provider, api, integration",
+        "Types: page, api, layout, component, tool, agent, prompt, workflow, task, resource, skill, integration",
         "Integration type launches interactive wizard if name not provided",
     ],
 };

package/esm/cli/commands/generate/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command.ts"],"names":[],"mappings":"AAwBA,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA8Hf"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/command.ts"],"names":[],"mappings":"AAsBA,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/esm/cli/commands/generate/command.js

@@ -1,124 +1,48 @@
-import { join } from "../../../deps/jsr.io/@std/path/1.1.4/mod.js";
 import { getConfig } from "../../../src/config/index.js";
 import { cliLogger } from "../../utils/index.js";
 import { createError, toError } from "../../../src/errors/index.js";
-import { createFileSystem } from "../../../src/platform/index.js";
 import { generateIntegration } from "./integration-generator.js";
-import { ensureDir } from "../../utils/fs.js";
-import { toComponentName, toSlug } from "../../utils/string.js";
+import { isScaffoldType, scaffoldProjectFile } from "../../scaffold/engine.js";
 async function getPreferredRouter(projectDir) {
     try {
         const { runtime } = await import("../../../src/platform/index.js");
         const adapter = await runtime.get();
         const cfg = await getConfig(projectDir, adapter);
         const pref = cfg?.generate?.preferredRouter ?? cfg?.router;
-        if (pref === "app-router" || pref === "pages-router")
-            return pref;
+        if (pref === "app-router" || pref === "app")
+            return "app-router";
+        if (pref === "pages-router" || pref === "pages")
+            return "pages-router";
     }
     catch {
         cliLogger.debug("Could not load config for generate command, using defaults");
     }
-    return "pages-router";
+    return "app-router";
 }
 export async function generateCommand(projectDir, type, name) {
-    const fs = createFileSystem();
     const preferred = await getPreferredRouter(projectDir);
-    const slug = toSlug(name);
     if (type === "integration") {
         await generateIntegration(projectDir, { name: name || undefined });
         return;
     }
-    switch (type) {
-        case "rsc": {
-            const dir = join(projectDir, "app", slug || "");
-            await ensureDir(dir);
-            const file = join(dir, "page.tsx");
-            const title = slug.split("/").pop() || "RSC";
-            const componentName = toComponentName(title);
-            const content = `export default function ${componentName}(){
-  return (
-    <div>
-      <h1>${title}</h1>
-      <p>Open the experimental RSC shell for this route:</p>
-      <a href="/_veryfront/rsc/page?name=${componentName}">RSC Shell</a>
-    </div>
-  );
-}
-`;
-            await fs.writeTextFile(file, content);
-            cliLogger.info(`Created ${file}`);
-            return;
-        }
-        case "page": {
-            if (preferred === "app-router") {
-                const pageDir = join(projectDir, "app", slug || "");
-                await ensureDir(pageDir);
-                const file = join(pageDir, "page.tsx");
-                const title = slug.split("/").pop() || "Page";
-                const componentName = toComponentName(title);
-                const content = `export default function ${componentName}(){ return <div>${title}</div>; }\n`;
-                await fs.writeTextFile(file, content);
-                cliLogger.info(`Created ${file}`);
-                return;
-            }
-            const parts = slug.split("/");
-            const subdir = slug.includes("/") ? parts.slice(0, -1).join("/") : "";
-            const base = join(projectDir, "pages");
-            const targetDir = subdir ? join(base, subdir) : base;
-            await ensureDir(targetDir);
-            const fname = `${parts.pop() || "index"}.mdx`;
-            const file = join(targetDir, fname);
-            const title = slug.split("/").pop() || "Page";
-            const content = `---\ntitle: ${title}\n---\n\n# ${title}\n\nThis is a new page.\n`;
-            await fs.writeTextFile(file, content);
-            cliLogger.info(`Created ${file}`);
-            return;
-        }
-        case "layout": {
-            if (preferred === "app-router") {
-                const dir = join(projectDir, "app", slug || "");
-                await ensureDir(dir);
-                const file = join(dir, "layout.tsx");
-                const content = `export default function Layout({ children }: { children: React.ReactNode }){ return (<section>${slug || "root"}{children}</section>); }\n`;
-                await fs.writeTextFile(file, content);
-                cliLogger.info(`Created ${file}`);
-                return;
-            }
-            const dir = join(projectDir, "layouts");
-            await ensureDir(dir);
-            const file = join(dir, `${slug}.mdx`);
-            const componentName = toComponentName(slug);
-            const content = `---\nisLayout: true\n---\n\nexport default function ${componentName}({ children }) {\n  return (<div className="${slug}-layout"><main>{children}</main></div>);\n}\n`;
-            await fs.writeTextFile(file, content);
-            cliLogger.info(`Created ${file}`);
-            return;
-        }
-        case "api": {
-            if (preferred === "app-router") {
-                const routeDir = join(projectDir, "app", slug || "");
-                await ensureDir(routeDir);
-                const file = join(routeDir, "route.ts");
-                const content = `export const GET = (_req: Request) => Response.json({ ok: true });\n`;
-                await fs.writeTextFile(file, content);
-                cliLogger.info(`Created ${file}`);
-                return;
-            }
-            const parts = slug.split("/");
-            const subdir = slug.includes("/") ? parts.slice(0, -1).join("/") : "";
-            const apiBase = join(projectDir, "pages", "api");
-            const targetDir = subdir ? join(apiBase, subdir) : apiBase;
-            await ensureDir(targetDir);
-            const fname = `${parts.pop() || "index"}.ts`;
-            const file = join(targetDir, fname);
-            const content = `export function GET(_req: Request) {\n  return new Response(JSON.stringify({ ok: true }), { headers: { 'content-type': 'application/json' } });\n}\n`;
-            await fs.writeTextFile(file, content);
-            cliLogger.info(`Created ${file}`);
-            return;
-        }
-        default:
-            throw toError(createError({
-                type: "config",
-                message: `Unknown generate type: ${type}`,
-            }));
+    if (!isScaffoldType(type)) {
+        throw toError(createError({
+            type: "config",
+            message: `Unknown generate type: ${type}`,
+        }));
+    }
+    const result = await scaffoldProjectFile({
+        projectDir,
+        type,
+        name,
+        router: preferred,
+    });
+    if (!result.success) {
+        throw toError(createError({
+            type: "config",
+            message: result.message,
+        }));
     }
+    for (const file of result.files)
+        cliLogger.info(`Created ${file.path}`);
 }

package/esm/cli/commands/generate/handler.d.ts

@@ -3,7 +3,7 @@
  */
 import type { ParsedArgs } from "../../shared/types.js";
 export declare const parseGenerateArgs: (args: ParsedArgs) => import("../../shared/args.js").SafeParseResult<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
-    type: import("../../../src/internal-agents/schema.js").Schema<"page" | "api" | "layout" | "provider" | "integration" | undefined>;
+    type: import("../../../src/internal-agents/schema.js").Schema<"prompt" | "page" | "api" | "agent" | "layout" | "resource" | "component" | "task" | "tool" | "integration" | "skill" | "workflow" | undefined>;
     name: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;
 }>>;
 export declare function handleGenerateCommand(args: ParsedArgs): Promise<void>;

package/esm/cli/commands/generate/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAcxD,eAAO,MAAM,iBAAiB;;;GAG5B,CAAC;AAEH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B3E"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAexD,eAAO,MAAM,iBAAiB;;;GAG5B,CAAC;AAEH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B3E"}

package/esm/cli/commands/generate/handler.js

@@ -6,7 +6,8 @@ import { generateCommand } from "./index.js";
 import { showLogo } from "../../utils/index.js";
 import { createArgParser } from "../../shared/args.js";
 import { cwd } from "../../../src/platform/index.js";
-const VALID_TYPES = ["page", "layout", "provider", "api", "integration"];
+import { SCAFFOLD_TYPES } from "../../scaffold/engine.js";
+const VALID_TYPES = [...SCAFFOLD_TYPES, "integration"];
 const getGenerateArgsSchema = defineSchema((v) => v.object({
     type: v.enum(VALID_TYPES).optional(),
     name: v.string().optional(),

package/esm/cli/commands/generate/integration-generator.js

@@ -34,7 +34,7 @@ export async function generateIntegration(projectDir, options = {}) {
     console.log(green("Integration created successfully!"));
     console.log("");
     console.log("Files created:");
-    console.log(`  ${cyan("ai/integrations/" + config.name + "/")} - Integration directory`);
+    console.log(`  ${cyan("integrations/" + config.name + "/")} - Integration directory`);
     console.log("");
     console.log("Next steps:");
     console.log(`  1. Add your ${config.envVarPrefix}_* environment variables to .env`);
@@ -42,7 +42,7 @@ export async function generateIntegration(projectDir, options = {}) {
         console.log(`  2. Configure OAuth app in ${config.displayName} developer portal`);
         console.log(`  3. Set callback URL to: /api/auth/${config.name}/callback`);
     }
-    console.log(`  4. Customize the generated tools in ai/integrations/${config.name}/tools/`);
+    console.log(`  4. Customize the generated tools in integrations/${config.name}/tools/`);
     console.log("");
 }
 async function getInteractiveConfig(options) {
@@ -103,7 +103,7 @@ async function getInteractiveConfig(options) {
     };
 }
 async function createIntegrationFiles(projectDir, config) {
-    const baseDir = join(projectDir, "ai", "integrations", config.name);
+    const baseDir = join(projectDir, "integrations", config.name);
     await ensureDir(baseDir);
     await ensureDir(join(baseDir, "lib"));
     await ensureDir(join(baseDir, "tools"));
@@ -381,7 +381,7 @@ export async function GET(): Promise<Response> {
 import {
   exchangeCodeForTokens,
   setTokens,
-} from "../../../../ai/integrations/${config.name}/lib/token-store.ts";
+} from "../../../../integrations/${config.name}/lib/token-store.ts";
 
 const USE_PKCE = ${usePKCELiteral};
 const PKCE_COOKIE_NAME = ${JSON.stringify(pkceCookieName)};

package/esm/cli/commands/init/init-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init-command.ts"],"names":[],"mappings":"AAAA;;;iCAGiC;AAWjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AAiKzE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8YrE"}
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/init-command.ts"],"names":[],"mappings":"AAAA;;;iCAGiC;AAWjC,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,YAAY,CAAC;AA6PzE;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA6arE"}

package/esm/cli/commands/init/init-command.js

@@ -138,6 +138,80 @@ function dedupeEnvVars(envVars) {
         return true;
     });
 }
+const STRUCTURE_ORDER = [
+    "app",
+    "pages",
+    "agents",
+    "tools",
+    "workflows",
+    "tasks",
+    "prompts",
+    "resources",
+    "skills",
+    "components",
+    "lib",
+    "content",
+    "AGENTS.md",
+    "README.md",
+    "package.json",
+    "deno.json",
+    "tsconfig.json",
+    ".env",
+    ".env.example",
+    ".gitignore",
+];
+function structureRank(name) {
+    const index = STRUCTURE_ORDER.indexOf(name);
+    return index === -1 ? STRUCTURE_ORDER.length : index;
+}
+function sortStructureEntries([nameA, nodeA], [nameB, nodeB]) {
+    const rankDiff = structureRank(nameA) - structureRank(nameB);
+    if (rankDiff !== 0)
+        return rankDiff;
+    if (nodeA.file !== nodeB.file)
+        return nodeA.file ? 1 : -1;
+    return nameA.localeCompare(nameB);
+}
+function renderProjectStructure(rootName, paths, maxLines = 22) {
+    const root = { file: false, children: new Map() };
+    const normalizedPaths = [...new Set(paths)]
+        .filter((path) => path && !path.endsWith("/"))
+        .sort();
+    for (const path of normalizedPaths) {
+        const parts = path.split("/").filter(Boolean);
+        let current = root;
+        for (const [index, part] of parts.entries()) {
+            const isFile = index === parts.length - 1;
+            let child = current.children.get(part);
+            if (!child) {
+                child = { file: isFile, children: new Map() };
+                current.children.set(part, child);
+            }
+            if (isFile)
+                child.file = true;
+            current = child;
+        }
+    }
+    const lines = [`${rootName}/`];
+    let omitted = 0;
+    function walk(node, depth) {
+        const entries = [...node.children.entries()].sort(sortStructureEntries);
+        for (const [name, child] of entries) {
+            if (lines.length >= maxLines) {
+                omitted++;
+                continue;
+            }
+            lines.push(`${"  ".repeat(depth)}${name}${child.file ? "" : "/"}`);
+            if (!child.file)
+                walk(child, depth + 1);
+        }
+    }
+    walk(root, 1);
+    if (omitted > 0) {
+        lines.push(`${"  ".repeat(1)}... ${omitted} more ${omitted === 1 ? "entry" : "entries"}`);
+    }
+    return lines;
+}
 /**
  * Initializes a new Veryfront project with the specified template
  */
@@ -204,7 +278,7 @@ export async function initCommand(options) {
             message: `Directory "${projectName}" already exists. Choose a different name or use --force to overwrite.`,
         }));
     }
-    const { getTemplate, getTemplateConfig } = await import("../../templates/index.js");
+    const { getAiRuleTemplate, getTemplate, getTemplateConfig } = await import("../../templates/index.js");
     let templateFiles = await getTemplate(template);
     const templateConfig = getTemplateConfig(template);
     if (!templateFiles) {
@@ -213,6 +287,18 @@ export async function initCommand(options) {
             message: `Template ${template} not found`,
         }));
     }
+    const agentsGuide = getAiRuleTemplate("agents.md");
+    if (!agentsGuide) {
+        throw toError(createError({
+            type: "config",
+            message: "Project agent guide template not found",
+        }));
+    }
+    if (!templateFiles.some((file) => file.path === "AGENTS.md")) {
+        templateFiles = mergeFiles(templateFiles, [
+            { path: "AGENTS.md", content: agentsGuide },
+        ]);
+    }
     const allEnvVars = templateConfig?.envVars ? [...templateConfig.envVars] : [];
     const featureTips = [];
     let loadedIntegrations = [];
@@ -274,6 +360,7 @@ export async function initCommand(options) {
         await ensureDir(projectDir);
     // Create project files with progress spinner
     const filesSpinner = quiet ? null : createSpinner("Creating project files...");
+    const createdPaths = [];
     try {
         for (const file of templateFiles) {
             if (file.path === ".env" || file.path === ".env.example")
@@ -283,6 +370,7 @@ export async function initCommand(options) {
             if (fileDir !== projectDir)
                 await ensureDir(fileDir);
             await fs.writeTextFile(filePath, file.content);
+            createdPaths.push(file.path);
             logger.debug(`Created file: ${file.path}`);
         }
         // Skip in quiet/TUI mode since local dev uses CDN and package.json can cause hydration issues
@@ -294,8 +382,10 @@ export async function initCommand(options) {
                     npmDependencies: integration.config.npmDependencies,
                 })),
             });
+            createdPaths.push("package.json");
             if (runtime === "deno") {
                 await createDenoConfig(projectDir);
+                createdPaths.push("deno.json");
             }
         }
         if (allEnvVars.length) {
@@ -304,8 +394,10 @@ export async function initCommand(options) {
                 prefilledValues: options.env,
             });
             await fs.writeTextFile(join(projectDir, ".env"), envResult.envContent);
+            createdPaths.push(".env");
             logger.debug("Created file: .env");
             await fs.writeTextFile(join(projectDir, ".env.example"), envResult.envExampleContent);
+            createdPaths.push(".env.example");
             logger.debug("Created file: .env.example");
         }
         const gitignorePath = join(projectDir, ".gitignore");
@@ -317,6 +409,7 @@ export async function initCommand(options) {
             existingGitignore = undefined;
         }
         await fs.writeTextFile(gitignorePath, generateGitignoreContent(existingGitignore));
+        createdPaths.push(".gitignore");
         logger.debug("Updated file: .gitignore");
         filesSpinner?.success("Project files created");
     }
@@ -422,9 +515,15 @@ export async function initCommand(options) {
     }
     localSteps.push(devCommand);
     const displayName = projectName ?? "Project";
+    const structureRoot = projectName ?? ".";
+    const structureLines = renderProjectStructure(structureRoot, createdPaths);
     const successContent = [
         `${green("✓")} ${displayName} ready!`,
         "",
+        `${brand("Project structure")}`,
+        ...structureLines,
+        "",
+        `${brand("Next steps")}`,
         ...localSteps,
     ];
     if (deployedSlug) {

package/esm/cli/commands/mcp/command-help.js

@@ -26,7 +26,7 @@ export const mcpHelp = {
         "  • vf_create_project       - Create new project from template",
         "  • vf_get_errors           - Real-time compile/runtime errors",
         "  • vf_preview_route        - HTTP response without browser",
-        "  • vf_scaffold             - Generate pages/APIs/components/tools",
+        "  • vf_scaffold             - Generate routes, components, and AI primitives",
         "  • vf_list_routes          - Structured route manifest",
         "  • vf_trigger_hmr          - Force browser refresh",
     ],

package/esm/cli/commands/skills/command-help.js

@@ -12,7 +12,7 @@ export const skillsHelp = {
         "veryfront skills info scaffold-app",
         "veryfront skills info deploy-safely --json",
         "veryfront skills create my-skill",
-        "veryfront skills validate ./my-skill",
+        "veryfront skills validate ./skills/my-skill",
     ],
     notes: [
         "Subcommands: list (default), info, create, validate",

package/esm/cli/commands/skills/command.d.ts

@@ -1,5 +1,5 @@
 /**
- * Skills command — list and inspect agent skills
+ * Skills command, list and inspect agent skills
  *
  * @module cli/commands/skills
  */

package/esm/cli/commands/skills/command.js

@@ -1,5 +1,5 @@
 /**
- * Skills command — list and inspect agent skills
+ * Skills command, list and inspect agent skills
  *
  * @module cli/commands/skills
  */
@@ -9,7 +9,7 @@ export async function listSkills() {
 }
 export async function getSkillInfo(name) {
     const skills = await listAllSkills();
-    const found = skills.find((s) => s.manifest.name === name);
+    const found = skills.find((s) => s.metadata.name === name);
     if (found)
         return found;
     // Try loading directly by path

package/esm/cli/commands/skills/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/create.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AA6CxD,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCjE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/create.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQxD,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCjE"}

package/esm/cli/commands/skills/create.js

@@ -1,43 +1,14 @@
 /**
- * Skills create command — scaffold a new skill
+ * Skills create command, scaffold a new skill
  *
  * @module cli/commands/skills/create
  */
 import * as dntShim from "../../../_dnt.shims.js";
+import { relative } from "../../../deps/jsr.io/@std/path/1.1.4/mod.js";
 import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
 import { logSuccess } from "../../utils/index.js";
-import { createFileSystem } from "../../../src/platform/index.js";
+import { scaffoldProjectFile } from "../../scaffold/engine.js";
 const VALID_SKILL_NAME = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
-const SKILL_JSON_TEMPLATE = (name) => JSON.stringify({
-    name,
-    version: "1.0.0",
-    description: `${name} skill`,
-    requires: {
-        cli: [],
-        mcp: [],
-    },
-    inputs: {},
-}, null, 2);
-const SKILL_MD_TEMPLATE = (name) => `# ${name}
-
-## Overview
-
-Describe what this skill does.
-
-## Steps
-
-1. **Step 1** — Description
-   \`\`\`bash
-   veryfront <command> --json
-   \`\`\`
-
-2. **Step 2** — Description
-
-## Error Recovery
-
-- If step 1 fails: ...
-- If step 2 fails: ...
-`;
 export async function createSkill(args) {
     const name = args._[2];
     if (!name) {
@@ -48,18 +19,21 @@ export async function createSkill(args) {
         console.error(`Invalid skill name "${name}". Use lowercase letters, numbers, and hyphens (e.g. "my-skill").`);
         dntShim.Deno.exit(1);
     }
-    const fs = createFileSystem();
-    const dir = name;
-    await fs.mkdir(dir, { recursive: true });
-    await fs.writeTextFile(`${dir}/skill.json`, SKILL_JSON_TEMPLATE(name));
-    await fs.writeTextFile(`${dir}/SKILL.md`, SKILL_MD_TEMPLATE(name));
+    const projectDir = dntShim.Deno.cwd();
+    const result = await scaffoldProjectFile({
+        projectDir,
+        type: "skill",
+        name,
+    });
+    if (!result.success)
+        throw new Error(result.message);
     if (isJsonMode()) {
         await outputJson(createSuccessEnvelope("skills", {
             created: name,
-            files: [`${dir}/skill.json`, `${dir}/SKILL.md`],
+            files: result.files.map((file) => relative(projectDir, file.path)),
         }));
         return;
     }
-    logSuccess(`Created skill "${name}" at ./${dir}/`);
-    console.log(`  Files: skill.json, SKILL.md`);
+    logSuccess(`Created skill "${name}" at ./skills/${name}/`);
+    console.log(`  Files: skills/${name}/SKILL.md`);
 }

package/esm/cli/commands/skills/handler.js

@@ -20,10 +20,10 @@ async function handleSkillList() {
     const skills = await listSkills();
     if (isJsonMode()) {
         await outputJson(createSuccessEnvelope("skills", skills.map((s) => ({
-            name: s.manifest.name,
-            version: s.manifest.version,
-            description: s.manifest.description,
-            requires: s.manifest.requires,
+            name: s.metadata.name,
+            description: s.metadata.description,
+            allowedTools: s.metadata.allowedTools,
+            directory: s.directory,
         }))));
         return;
     }
@@ -34,8 +34,10 @@ async function handleSkillList() {
     }
     console.log(`\n  ${bold("Available Skills")}\n`);
     for (const skill of skills) {
-        console.log(`  ${bold(skill.manifest.name)} ${dim(`v${skill.manifest.version}`)}`);
-        console.log(`    ${skill.manifest.description}`);
+        const version = skill.metadata.metadata?.version;
+        const suffix = version ? ` ${dim(`v${version}`)}` : "";
+        console.log(`  ${bold(skill.metadata.name)}${suffix}`);
+        console.log(`    ${skill.metadata.description}`);
     }
     console.log();
 }
@@ -52,21 +54,18 @@ async function handleSkillInfo(args) {
     }
     if (isJsonMode()) {
         await outputJson(createSuccessEnvelope("skills", {
-            ...skill.manifest,
+            ...skill.metadata,
             content: skill.skillMd,
             directory: skill.directory,
         }));
         return;
     }
-    console.log(`\n  ${bold(skill.manifest.name)} ${dim(`v${skill.manifest.version}`)}`);
-    console.log(`  ${skill.manifest.description}\n`);
-    if (skill.manifest.requires) {
-        if (skill.manifest.requires.cli?.length) {
-            console.log(`  ${dim("CLI:")} ${skill.manifest.requires.cli.join(", ")}`);
-        }
-        if (skill.manifest.requires.mcp?.length) {
-            console.log(`  ${dim("MCP:")} ${skill.manifest.requires.mcp.join(", ")}`);
-        }
+    const version = skill.metadata.metadata?.version;
+    const suffix = version ? ` ${dim(`v${version}`)}` : "";
+    console.log(`\n  ${bold(skill.metadata.name)}${suffix}`);
+    console.log(`  ${skill.metadata.description}\n`);
+    if (skill.metadata.allowedTools?.length) {
+        console.log(`  ${dim("Allowed tools:")} ${skill.metadata.allowedTools.join(", ")}`);
     }
     if (skill.skillMd) {
         console.log(`\n${skill.skillMd}`);

package/esm/cli/commands/skills/validate.d.ts

@@ -1,3 +1,9 @@
 import type { ParsedArgs } from "../../shared/types.js";
+interface ValidationIssue {
+    severity: "error" | "warning";
+    message: string;
+}
 export declare function validateSkill(args: ParsedArgs): Promise<void>;
+export declare function validateSkillDirectory(dir: string): Promise<ValidationIssue[]>;
+export {};
 //# sourceMappingURL=validate.d.ts.map

package/esm/cli/commands/skills/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/validate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAYxD,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDnE"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/validate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOxD,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuBpF"}