@agentkitforge/core 0.1.0

package/SPEC.md

@@ -0,0 +1,159 @@
+# Agent Kit Specification
+
+This is the public preview Agent Kit package specification for AgentKitForge Core.
+
+## What Is an Agent Kit?
+
+An Agent Kit is a portable package of AI-agent skills, workflows, policies, references, templates, examples, evals, adapters, scripts, assets, prepared prompts, and exports.
+
+AgentKitForge Core validates, renders, packages, exports, and builds AI-ready context from Agent Kits. It does not call AI providers and does not execute scripts.
+
+## Canonical Package Structure
+
+Required for `local-valid`:
+
+```text
+agentkit.yaml
+AGENTKIT.md
+START_HERE.md
+skills/
+skills/<skill-id>/SKILL.md
+```
+
+Optional or profile-specific files and folders:
+
+```text
+README.md
+LICENSE
+CHANGELOG.md
+workflows/
+policies/
+references/
+templates/
+examples/
+examples/prompts/
+examples/inputs/
+examples/outputs/
+evals/
+adapters/
+scripts/
+assets/
+exports/
+prompts/
+prompts/<prompt-id>.yaml
+```
+
+## Manifest
+
+`agentkit.yaml` is the package manifest.
+
+Required fields:
+
+- `schemaVersion`
+- `kind`
+- `id`
+- `name`
+- `version`
+- `description`
+- `author.name`
+- `license`
+- `entrypoints.human`
+- `entrypoints.agent`
+- `userExperience.setupLevel`
+- `compatibility.targets`
+- `risk.level`
+- `skills[]`
+- `skills[].id`
+- `skills[].path`
+- `skills[].description`
+- `skills[].triggers`
+
+Current public preview schema:
+
+```yaml
+schemaVersion: "0.1"
+```
+
+## Skills
+
+Each manifest skill points to a `SKILL.md` file.
+
+Required frontmatter:
+
+- `id`
+- `name`
+- `description`
+- `triggers`
+- `riskLevel`
+
+Required Markdown sections:
+
+- `# Title`
+- `## Use when`
+- `## Procedure`
+- `## Output`
+
+## Prepared Prompts
+
+Prepared Prompts are reusable prompt templates stored under:
+
+```text
+prompts/<prompt-id>.yaml
+```
+
+Manifest entries are optional:
+
+```yaml
+prompts:
+  - id: financial-review
+    path: prompts/financial-review.yaml
+    description: Review a financial workbook and produce a summary.
+```
+
+Canonical variable syntax is `{{variable_name}}`. The simple `{variable_name}` form is tolerated for compatibility. Core validates inputs and blocks unresolved variables before a rendered prompt is considered valid.
+
+Supported input types:
+
+- `short-text`
+- `long-text`
+- `choice`
+- `multi-choice`
+- `date`
+- `number`
+- `boolean`
+
+## Validation Profiles
+
+`local-valid` requires:
+
+- `agentkit.yaml`
+- `AGENTKIT.md`
+- `START_HERE.md`
+- `skills/`
+- At least one `skills/<skill-id>/SKILL.md`
+
+`publishable` requires all `local-valid` requirements plus:
+
+- `README.md`
+- `LICENSE`
+
+`trusted` requires all `publishable` requirements plus:
+
+- `CHANGELOG.md`
+- `policies/`
+- `examples/`
+
+`verified` requires all `trusted` requirements plus:
+
+- `evals/`
+
+## Security Notes
+
+Agent Kits are untrusted input.
+
+- Manifest paths must be safe relative paths that resolve inside the kit root.
+- IDs used in filesystem paths must be path-safe kebab-case identifiers.
+- Path traversal, absolute paths, Windows drive-root paths, and null bytes are invalid.
+- Core does not execute files in `scripts/`.
+- Packaging, context building, and target exports reject symbolic links and apply conservative file-count and byte limits.
+- Generated and dependency-heavy folders such as `exports/`, `.git`, `node_modules`, `dist`, and `build` are skipped by package/export safety traversal.

package/VERSIONING.md

@@ -0,0 +1,45 @@
+# Versioning
+
+AgentKitForge Core uses Semantic Versioning.
+
+Version format:
+
+```text
+MAJOR.MINOR.PATCH
+```
+
+## Pre-1.0 Policy
+
+Before `1.0.0`, the public API and Agent Kit schema are still stabilizing.
+
+- Minor versions, such as `0.2.0`, may include breaking changes.
+- Patch versions, such as `0.1.1`, are for fixes, security fixes, documentation corrections, and compatible improvements.
+- Breaking changes should be documented clearly in release notes.
+
+Release Please uses Conventional Commits to determine version bumps:
+
+- `feat:` creates a minor release.
+- `fix:` creates a patch release.
+- `security:` creates a patch release.
+- Breaking changes before `1.0.0` create a minor release, but must be documented in release notes and any affected spec docs.
+
+## Agent Kit Schema Compatibility
+
+Agent Kit manifests include `schemaVersion`.
+
+Current public preview schema:
+
+```yaml
+schemaVersion: "0.1"
+```
+
+Compatibility policy during public preview:
+
+- `schemaVersion: "0.1"` is the v0.1 public preview schema.
+- Compatible validator improvements may ship in patch releases.
+- Breaking schema changes should use a new schema version and be documented in `SPEC.md`, `CHANGELOG.md`, and release notes.
+- Deprecated fields should receive a migration note when practical.
+
+## Release Target
+
+The current release target is `v0.1.0 Public Preview`.

package/dist/adapters/claudeCode.d.ts

@@ -0,0 +1,11 @@
+export interface ClaudeCodeExportOptions {
+    force?: boolean;
+}
+export interface ClaudeCodeExportResult {
+    destinationDir: string;
+    pluginFolder: string;
+    exportedSkillFolders: string[];
+    pluginManifestPath: string;
+    warnings: string[];
+}
+export declare function exportAgentKitToClaudeCode(kitPath: string, destinationDir: string, options?: ClaudeCodeExportOptions): Promise<ClaudeCodeExportResult>;

package/dist/adapters/claudeCode.js

@@ -0,0 +1,120 @@
+import { copyFile, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { readAgentKit } from "../package/reader.js";
+import { assertSafeDestinationDirectory, assertSafeId, resolveInside, safeCopyDirectory } from "../fs/safety.js";
+const MARKER_FILE = ".agentkitforge-export.json";
+const SUPPORTING_DIRECTORIES = ["policies", "templates", "workflows", "references"];
+export async function exportAgentKitToClaudeCode(kitPath, destinationDir, options = {}) {
+    const kit = await readAgentKit(kitPath);
+    if (!kit.manifest) {
+        throw new Error("Unable to export to Claude Code because agentkit.yaml is invalid.");
+    }
+    const resolvedDestination = path.resolve(destinationDir);
+    assertSafeId(kit.manifest.id, "kit id");
+    for (const skill of kit.manifest.skills) {
+        assertSafeId(skill.id, "skill id");
+    }
+    await assertSafeDestinationDirectory(resolvedDestination);
+    await mkdir(resolvedDestination, { recursive: true });
+    const pluginFolder = resolveInside(resolvedDestination, pluginFolderName(kit.manifest));
+    await preparePluginFolder(pluginFolder, options.force === true);
+    await mkdir(pluginFolder, { recursive: true });
+    await writePluginManifest(pluginFolder, kit.manifest);
+    await writeMarker(pluginFolder, kit.manifest);
+    await copyIfPresent(resolveInside(kit.rootPath, "AGENTKIT.md"), resolveInside(pluginFolder, "AGENTKIT.md"));
+    await copyIfPresent(resolveInside(kit.rootPath, "README.md"), resolveInside(pluginFolder, "README.md"));
+    const exportedSkillFolders = [];
+    for (const skill of [...kit.manifest.skills].sort((left, right) => left.id.localeCompare(right.id))) {
+        const sourceSkillDir = path.dirname(resolveInside(kit.rootPath, skill.path));
+        const destinationSkillDir = resolveInside(pluginFolder, `skills/${skill.id}`);
+        await mkdir(path.dirname(destinationSkillDir), { recursive: true });
+        await safeCopyDirectory(sourceSkillDir, destinationSkillDir);
+        exportedSkillFolders.push(destinationSkillDir);
+    }
+    for (const directory of SUPPORTING_DIRECTORIES) {
+        await copyDirectoryIfPresent(resolveInside(kit.rootPath, directory), resolveInside(pluginFolder, directory));
+    }
+    return {
+        destinationDir: resolvedDestination,
+        pluginFolder,
+        exportedSkillFolders,
+        pluginManifestPath: resolveInside(pluginFolder, ".claude-plugin/plugin.json"),
+        warnings: [
+            "Claude Code plugin schema support is an initial AgentKitForge adapter; verify loading behavior with your Claude Code version."
+        ]
+    };
+}
+async function preparePluginFolder(pluginFolder, force) {
+    if (!(await exists(pluginFolder))) {
+        return;
+    }
+    if (!force) {
+        throw new Error(`Refusing to overwrite existing Claude Code plugin folder: ${pluginFolder}. Use --force to replace the AgentKitForge-generated plugin folder.`);
+    }
+    await assertAgentKitForgeGeneratedPlugin(pluginFolder);
+    await rm(pluginFolder, { recursive: true, force: true });
+}
+async function assertAgentKitForgeGeneratedPlugin(pluginFolder) {
+    const markerPath = resolveInside(pluginFolder, MARKER_FILE);
+    if (!(await exists(markerPath))) {
+        throw new Error(`Refusing to remove non-AgentKitForge plugin folder: ${pluginFolder}`);
+    }
+    const marker = JSON.parse(await readFile(markerPath, "utf8"));
+    if (marker.generatedBy !== "agentkitforge" || marker.target !== "claude-code") {
+        throw new Error(`Refusing to remove plugin folder without Claude Code AgentKitForge marker: ${pluginFolder}`);
+    }
+}
+async function writePluginManifest(pluginFolder, manifest) {
+    const pluginManifestPath = resolveInside(pluginFolder, ".claude-plugin/plugin.json");
+    await mkdir(path.dirname(pluginManifestPath), { recursive: true });
+    await writeFile(pluginManifestPath, `${JSON.stringify({
+        generatedBy: "agentkitforge",
+        target: "claude-code",
+        schemaVersion: "0.1",
+        name: manifest.name,
+        id: manifest.id,
+        version: manifest.version,
+        description: manifest.description,
+        author: manifest.author?.name,
+        skills: manifest.skills.map((skill) => ({
+            id: skill.id,
+            path: `skills/${skill.id}/SKILL.md`,
+            description: skill.description,
+            triggers: skill.triggers
+        }))
+    }, null, 2)}\n`, "utf8");
+}
+async function writeMarker(pluginFolder, manifest) {
+    await writeFile(resolveInside(pluginFolder, MARKER_FILE), `${JSON.stringify({
+        generatedBy: "agentkitforge",
+        target: "claude-code",
+        kitId: manifest.id
+    }, null, 2)}\n`, "utf8");
+}
+async function copyIfPresent(source, destination) {
+    if (!(await exists(source))) {
+        return;
+    }
+    await mkdir(path.dirname(destination), { recursive: true });
+    await mkdir(path.dirname(destination), { recursive: true });
+    await copyFile(source, destination);
+}
+async function copyDirectoryIfPresent(source, destination) {
+    if (!(await exists(source))) {
+        return;
+    }
+    await safeCopyDirectory(source, destination);
+}
+function pluginFolderName(manifest) {
+    return `${manifest.id}-claude-code-plugin`;
+}
+async function exists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=claudeCode.js.map

package/dist/adapters/claudeCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCode.js","sourceRoot":"","sources":["../../src/adapters/claudeCode.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,12 @@
+export type AgentKitTarget = "codex" | "claude-code";
+export interface CodexExportOptions {
+    force?: boolean;
+    createIndexSkill?: boolean;
+}
+export interface CodexExportResult {
+    destinationSkillsDir: string;
+    exportedSkillFolders: string[];
+    generatedIndexFolder?: string;
+    warnings: string[];
+}
+export declare function exportAgentKitToCodex(kitPath: string, destinationSkillsDir: string, options?: CodexExportOptions): Promise<CodexExportResult>;

package/dist/adapters/codex.js

@@ -0,0 +1,141 @@
+import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { readAgentKit } from "../package/reader.js";
+import { assertSafeDestinationDirectory, assertSafeId, resolveInside, safeCopyDirectory } from "../fs/safety.js";
+const MARKER_FILE = ".agentkitforge-export.json";
+export async function exportAgentKitToCodex(kitPath, destinationSkillsDir, options = {}) {
+    const kit = await readAgentKit(kitPath);
+    if (!kit.manifest) {
+        throw new Error("Unable to export to Codex because agentkit.yaml is invalid.");
+    }
+    const destinationRoot = path.resolve(destinationSkillsDir);
+    assertSafeId(kit.manifest.id, "kit id");
+    for (const skill of kit.manifest.skills) {
+        assertSafeId(skill.id, "skill id");
+    }
+    await assertSafeDestinationDirectory(destinationRoot);
+    await mkdir(destinationRoot, { recursive: true });
+    const createIndexSkill = options.createIndexSkill !== false;
+    const plannedFolders = [
+        ...kit.manifest.skills.map((skill) => folderNameForSkill(kit.manifest, skill)),
+        ...(createIndexSkill ? [folderNameForIndex(kit.manifest)] : [])
+    ];
+    await prepareDestinationFolders(destinationRoot, plannedFolders, options.force === true);
+    const exportedSkillFolders = [];
+    for (const skill of [...kit.manifest.skills].sort((left, right) => left.id.localeCompare(right.id))) {
+        const folderName = folderNameForSkill(kit.manifest, skill);
+        const destinationFolder = resolveInside(destinationRoot, folderName);
+        await mkdir(destinationFolder, { recursive: true });
+        await exportSkillFolder(kit.rootPath, kit.manifest, skill, destinationFolder);
+        exportedSkillFolders.push(destinationFolder);
+    }
+    let generatedIndexFolder;
+    if (createIndexSkill) {
+        const folderName = folderNameForIndex(kit.manifest);
+        const destinationFolder = resolveInside(destinationRoot, folderName);
+        await mkdir(destinationFolder, { recursive: true });
+        await writeFile(resolveInside(destinationFolder, "SKILL.md"), renderIndexSkill(kit.manifest), "utf8");
+        await writeMarker(destinationFolder, kit.manifest, "index");
+        generatedIndexFolder = destinationFolder;
+    }
+    return {
+        destinationSkillsDir: destinationRoot,
+        exportedSkillFolders,
+        generatedIndexFolder,
+        warnings: []
+    };
+}
+async function exportSkillFolder(kitRoot, manifest, skill, destinationFolder) {
+    const sourceSkillFile = resolveInside(kitRoot, skill.path);
+    const sourceSkillDir = path.dirname(sourceSkillFile);
+    await safeCopyDirectory(sourceSkillDir, destinationFolder);
+    await writeFile(resolveInside(destinationFolder, "AGENTKIT.md"), renderSkillAgentKitReadme(manifest, skill), "utf8");
+    await writeMarker(destinationFolder, manifest, skill.id);
+}
+async function prepareDestinationFolders(destinationRoot, plannedFolders, force) {
+    const existingFolders = [];
+    for (const folderName of plannedFolders) {
+        const folderPath = resolveInside(destinationRoot, folderName);
+        if (await exists(folderPath)) {
+            existingFolders.push(folderPath);
+        }
+    }
+    if (existingFolders.length > 0 && !force) {
+        throw new Error(`Refusing to overwrite existing Codex skill export folders: ${existingFolders.join(", ")}. Use --force to replace AgentKitForge-generated folders.`);
+    }
+    for (const folderPath of existingFolders) {
+        await assertAgentKitForgeGeneratedFolder(folderPath);
+        await rm(folderPath, { recursive: true, force: true });
+    }
+}
+async function assertAgentKitForgeGeneratedFolder(folderPath) {
+    const markerPath = resolveInside(folderPath, MARKER_FILE);
+    if (!(await exists(markerPath))) {
+        throw new Error(`Refusing to remove non-AgentKitForge folder: ${folderPath}`);
+    }
+    const marker = JSON.parse(await readFile(markerPath, "utf8"));
+    if (marker.generatedBy !== "agentkitforge") {
+        throw new Error(`Refusing to remove folder without AgentKitForge marker: ${folderPath}`);
+    }
+}
+async function writeMarker(destinationFolder, manifest, skillId) {
+    await writeFile(resolveInside(destinationFolder, MARKER_FILE), `${JSON.stringify({
+        generatedBy: "agentkitforge",
+        target: "codex",
+        kitId: manifest.id,
+        skillId
+    }, null, 2)}\n`, "utf8");
+}
+function renderSkillAgentKitReadme(manifest, skill) {
+    return `# ${manifest.name}: ${skill.id}
+
+This Codex skill was exported from Agent Kit \`${manifest.id}\`.
+
+${skill.description}
+`;
+}
+function renderIndexSkill(manifest) {
+    return `---
+id: ${manifest.id}-index
+name: ${manifest.name} Index
+description: Overview of the ${manifest.name} Agent Kit and its exported Codex skills.
+triggers:
+  - ${manifest.name}
+  - ${manifest.id}
+riskLevel: ${manifest.risk.level}
+---
+
+# ${manifest.name} Index
+
+## Use when
+
+Use this skill when a user asks what the ${manifest.name} Agent Kit contains or which exported skill to use.
+
+## Procedure
+
+Review the Agent Kit description and choose the most relevant exported skill.
+
+Included skills:
+${manifest.skills.map((skill) => `- ${skill.id}: ${skill.description}`).join("\n")}
+
+## Output
+
+Return the recommended skill and a short reason.
+`;
+}
+function folderNameForSkill(manifest, skill) {
+    return `${manifest.id}-${skill.id}`;
+}
+function folderNameForIndex(manifest) {
+    return `${manifest.id}-index`;
+}
+async function exists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"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"}

package/dist/app/exampleInputDocuments.d.ts

@@ -0,0 +1,21 @@
+export type ExampleInputDocumentKind = "text" | "markdown" | "csv" | "spreadsheet";
+export interface ExampleInputDocument {
+    id: string;
+    name: string;
+    filename: string;
+    mediaType?: string;
+    kind: ExampleInputDocumentKind;
+    extractedText?: string;
+    tablePreview?: string[][];
+    notes?: string;
+}
+export interface ExampleInputDocumentSummary {
+    id: string;
+    name: string;
+    filename: string;
+    kind: ExampleInputDocumentKind;
+    notes?: string;
+}
+export declare function isSupportedExampleInputDocument(filename: string): boolean;
+export declare function inferExampleInputDocumentKind(filename: string): ExampleInputDocumentKind | undefined;
+export declare function summarizeExampleInputDocument(document: ExampleInputDocument): ExampleInputDocumentSummary;

package/dist/app/exampleInputDocuments.js

@@ -0,0 +1,24 @@
+const EXTENSION_TO_KIND = {
+    ".txt": "text",
+    ".md": "markdown",
+    ".csv": "csv",
+    ".xlsx": "spreadsheet",
+    ".xls": "spreadsheet"
+};
+export function isSupportedExampleInputDocument(filename) {
+    return inferExampleInputDocumentKind(filename) !== undefined;
+}
+export function inferExampleInputDocumentKind(filename) {
+    const extension = filename.slice(filename.lastIndexOf(".")).toLowerCase();
+    return EXTENSION_TO_KIND[extension];
+}
+export function summarizeExampleInputDocument(document) {
+    return {
+        id: document.id,
+        name: document.name,
+        filename: document.filename,
+        kind: document.kind,
+        notes: document.notes
+    };
+}
+//# sourceMappingURL=exampleInputDocuments.js.map

package/dist/app/exampleInputDocuments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exampleInputDocuments.js","sourceRoot":"","sources":["../../src/app/exampleInputDocuments.ts"],"names":[],"mappings":"AAqBA,MAAM,iBAAiB,GAA6C;IAClE,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,aAAa;CACtB,CAAC;AAEF,MAAM,UAAU,+BAA+B,CAAC,QAAgB;IAC9D,OAAO,6BAA6B,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAAgB;IAEhB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1E,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAA8B;IAE9B,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/dist/app/inspect.d.ts

@@ -0,0 +1,15 @@
+import type { ValidationReport } from "../types.js";
+export interface AgentKitCandidateInspection {
+    path: string;
+    exists: boolean;
+    isDirectory: boolean;
+    looksLikeAgentKit: boolean;
+    missingRequiredFiles: string[];
+    missingRequiredFolders: string[];
+    foundFiles: string[];
+    foundSkills: string[];
+    recommendedFixes: string[];
+    validationReport?: ValidationReport;
+    friendlySummary: string;
+}
+export declare function inspectAgentKitCandidate(inputPath: string): Promise<AgentKitCandidateInspection>;

package/dist/app/inspect.js

@@ -0,0 +1,96 @@
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { validateAgentKit } from "../validation/validator.js";
+export async function inspectAgentKitCandidate(inputPath) {
+    const rootPath = path.resolve(inputPath);
+    if (!(await exists(rootPath))) {
+        return {
+            path: rootPath,
+            exists: false,
+            isDirectory: false,
+            looksLikeAgentKit: false,
+            missingRequiredFiles: ["agentkit.yaml", "AGENTKIT.md", "START_HERE.md", "skills/<skill-id>/SKILL.md"],
+            missingRequiredFolders: ["skills"],
+            foundFiles: [],
+            foundSkills: [],
+            recommendedFixes: ["Select an existing Agent Kit folder."],
+            friendlySummary: `This folder does not exist: ${rootPath}`
+        };
+    }
+    const stats = await stat(rootPath);
+    if (!stats.isDirectory()) {
+        return {
+            path: rootPath,
+            exists: true,
+            isDirectory: false,
+            looksLikeAgentKit: false,
+            missingRequiredFiles: ["agentkit.yaml", "AGENTKIT.md", "START_HERE.md", "skills/<skill-id>/SKILL.md"],
+            missingRequiredFolders: ["skills"],
+            foundFiles: [],
+            foundSkills: [],
+            recommendedFixes: ["Select a folder that contains the Agent Kit files."],
+            friendlySummary: "This path exists but is not a directory."
+        };
+    }
+    const foundFiles = await findRootFiles(rootPath);
+    const foundSkills = await findSkills(rootPath);
+    const missingRequiredFiles = ["agentkit.yaml", "AGENTKIT.md", "START_HERE.md"].filter((file) => !foundFiles.includes(file));
+    const missingRequiredFolders = (await exists(path.join(rootPath, "skills"))) ? [] : ["skills"];
+    if (foundSkills.length === 0) {
+        missingRequiredFiles.push("skills/<skill-id>/SKILL.md");
+    }
+    const looksLikeAgentKit = missingRequiredFiles.length === 0 && missingRequiredFolders.length === 0;
+    const validationReport = looksLikeAgentKit ? await validateAgentKit(rootPath, "local-valid") : undefined;
+    const missing = [...missingRequiredFiles, ...missingRequiredFolders];
+    return {
+        path: rootPath,
+        exists: true,
+        isDirectory: true,
+        looksLikeAgentKit,
+        missingRequiredFiles,
+        missingRequiredFolders,
+        foundFiles,
+        foundSkills,
+        recommendedFixes: looksLikeAgentKit
+            ? []
+            : ["Place the Agent Kit files at the repository root or select a subfolder that contains the kit."],
+        validationReport,
+        friendlySummary: looksLikeAgentKit
+            ? "This folder looks like an Agent Kit."
+            : `This repository does not look like an Agent Kit. It is missing ${joinFriendly(missing)}. Place the Agent Kit files at the repository root or select a subfolder that contains the kit.`
+    };
+}
+async function findRootFiles(rootPath) {
+    const entries = await readdir(rootPath, { withFileTypes: true });
+    return entries.filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
+}
+async function findSkills(rootPath) {
+    const skillsPath = path.join(rootPath, "skills");
+    if (!(await exists(skillsPath))) {
+        return [];
+    }
+    const entries = await readdir(skillsPath, { withFileTypes: true });
+    const skills = [];
+    for (const entry of entries) {
+        if (entry.isDirectory() && (await exists(path.join(skillsPath, entry.name, "SKILL.md")))) {
+            skills.push(entry.name);
+        }
+    }
+    return skills.sort();
+}
+async function exists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function joinFriendly(values) {
+    if (values.length <= 1) {
+        return values[0] ?? "required Agent Kit files";
+    }
+    return `${values.slice(0, -1).join(", ")}, and ${values[values.length - 1]}`;
+}
+//# sourceMappingURL=inspect.js.map