agenticros 0.2.4 → 0.3.0

package/dist/util/skill-manifest.js

@@ -0,0 +1,81 @@
+/**
+ * Local validation of skill package.json manifests.
+ * Keep in sync with agenticros-skills/functions/src/util/manifest.ts
+ */
+export class ManifestError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ManifestError";
+    }
+}
+const SLUG_RE = /^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/;
+export function isValidSlug(slug) {
+    return SLUG_RE.test(slug);
+}
+export function validateManifest(raw) {
+    if (!raw || typeof raw !== "object") {
+        throw new ManifestError("package.json is missing or empty");
+    }
+    const m = raw;
+    if (!m.name || typeof m.name !== "string") {
+        throw new ManifestError("package.json must declare a `name`");
+    }
+    if (!m.version || typeof m.version !== "string") {
+        throw new ManifestError("package.json must declare a `version`");
+    }
+    if (!m.main || typeof m.main !== "string") {
+        throw new ManifestError("package.json must declare a `main` entry (e.g. `dist/index.js`).");
+    }
+    if (!m.agenticros || typeof m.agenticros !== "object") {
+        throw new ManifestError("package.json must declare an `agenticros` block. See https://skills.agenticros.com");
+    }
+    const block = m.agenticros;
+    if (!block.id || typeof block.id !== "string" || !isValidSlug(block.id)) {
+        throw new ManifestError("`agenticros.id` is required and must be a kebab-case slug (2-64 chars, [a-z0-9-]).");
+    }
+    const warnings = [];
+    if (m.agenticrosSkill !== undefined) {
+        warnings.push("The legacy `agenticrosSkill` field is deprecated. Move metadata into the `agenticros` block.");
+    }
+    const coreDep = m.dependencies?.["@agenticros/core"];
+    if (coreDep?.startsWith("file:")) {
+        warnings.push("`@agenticros/core` is declared as a `file:` path. Publish a version from npm (e.g. `^0.5.0`) before others can install your skill.");
+    }
+    if (!block.description && !m.description) {
+        warnings.push("Add a one-sentence `description` (top-level or in `agenticros`).");
+    }
+    if (!block.capabilities || block.capabilities.length === 0) {
+        warnings.push("Declare at least one capability in `agenticros.capabilities` so the agent planner can reason about your skill.");
+    }
+    if (!block.screenshots || block.screenshots.length === 0) {
+        warnings.push("Add at least one entry to `agenticros.screenshots` so the marketplace card has a preview image.");
+    }
+    return { manifest: m, block, warnings };
+}
+export function manifestRepoUrl(m) {
+    if (!m.repository)
+        return null;
+    if (typeof m.repository === "string")
+        return m.repository;
+    return m.repository.url ?? null;
+}
+export function firestoreDocId(ownerLogin, skillSlug) {
+    return `${ownerLogin.toLowerCase()}__${skillSlug}`;
+}
+export function marketplaceRef(ownerLogin, skillSlug) {
+    return `${ownerLogin.toLowerCase()}/${skillSlug}`;
+}
+export function parseMarketplaceRef(ref) {
+    const trimmed = ref.trim();
+    const slash = trimmed.indexOf("/");
+    if (slash <= 0 || slash === trimmed.length - 1)
+        return null;
+    const owner = trimmed.slice(0, slash).toLowerCase();
+    const skill = trimmed.slice(slash + 1);
+    if (!/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/.test(owner))
+        return null;
+    if (!isValidSlug(skill))
+        return null;
+    return { owner, skill };
+}
+//# sourceMappingURL=skill-manifest.js.map

package/dist/util/skill-manifest.js.map

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

package/dist/util/skill-scaffold.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Skill scaffolding — copy embedded templates into cwd/agenticros-skill-<slug>/.
+ */
+export type SkillTemplate = "hello" | "robot" | "camera" | "depth";
+export declare function normalizeTemplate(input: string | undefined): SkillTemplate;
+export declare function normalizeSkillSlug(input: string): string;
+export declare function slugToToolName(slug: string): string;
+export declare function slugToDisplayName(slug: string): string;
+export interface ScaffoldOptions {
+    slug: string;
+    template?: string;
+    cwd?: string;
+}
+export interface ScaffoldResult {
+    dir: string;
+    slug: string;
+    template: SkillTemplate;
+    toolName: string;
+}
+export declare function scaffoldSkill(opts: ScaffoldOptions): ScaffoldResult;
+/** SHA-256 of normalized template source (for tutorial graduation checks). */
+export declare function hashSkillSource(source: string): string;
+export declare function getTemplateFingerprints(): Record<SkillTemplate, string>;
+export declare function isUnmodifiedTemplate(source: string, template: SkillTemplate): boolean;
+export declare function readSkillIndexSource(skillDir: string): string | null;
+//# sourceMappingURL=skill-scaffold.d.ts.map

package/dist/util/skill-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scaffold.d.ts","sourceRoot":"","sources":["../../src/util/skill-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AA2CnE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAS1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcxD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAkCD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,CAiCnE;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAUvE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAKT;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpE"}

package/dist/util/skill-scaffold.js

@@ -0,0 +1,153 @@
+/**
+ * Skill scaffolding — copy embedded templates into cwd/agenticros-skill-<slug>/.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+const SLUG_RE = /^[a-z0-9][a-z0-9-]{0,62}[a-z0-9]$/;
+const TEMPLATE_ALIASES = {
+    hello: "hello",
+    h: "hello",
+    robot: "robot",
+    r: "robot",
+    camera: "camera",
+    c: "camera",
+    depth: "depth",
+    d: "depth",
+};
+const TEMPLATE_DEFAULTS = {
+    hello: {
+        displayName: "Hello World",
+        description: "My first AgenticROS skill — returns a friendly greeting.",
+    },
+    robot: {
+        displayName: "Wave Hand",
+        description: "Wave the robot base with a brief cmd_vel gesture.",
+    },
+    camera: {
+        displayName: "Describe Scene",
+        description: "Capture one frame from the robot camera.",
+    },
+    depth: {
+        displayName: "Measure Distance",
+        description: "Sample depth at the center of the depth image.",
+    },
+};
+/** Minimal 1×1 PNG (valid placeholder for docs/icon.png). */
+const PLACEHOLDER_PNG = Buffer.from("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==", "base64");
+export function normalizeTemplate(input) {
+    const key = (input ?? "hello").toLowerCase().trim();
+    const t = TEMPLATE_ALIASES[key];
+    if (!t) {
+        throw new Error(`Unknown template "${input}". Use: hello, robot, camera, or depth.`);
+    }
+    return t;
+}
+export function normalizeSkillSlug(input) {
+    const slug = input
+        .trim()
+        .toLowerCase()
+        .replace(/^@[^/]+\//, "")
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    if (!slug || !SLUG_RE.test(slug)) {
+        throw new Error("Skill slug must be kebab-case (2–64 chars, [a-z0-9-]), e.g. hello-world or follow-me.");
+    }
+    return slug;
+}
+export function slugToToolName(slug) {
+    return slug.replace(/-/g, "_");
+}
+export function slugToDisplayName(slug) {
+    return slug
+        .split("-")
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+function templatesRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "..", "..", "templates", "skills");
+}
+function substituteVars(content, vars) {
+    let out = content;
+    for (const [key, value] of Object.entries(vars)) {
+        out = out.replaceAll(`{{${key}}}`, value);
+    }
+    return out;
+}
+function copyTemplateTree(srcDir, destDir, vars) {
+    for (const name of readdirSync(srcDir)) {
+        const src = join(srcDir, name);
+        const dest = join(destDir, name);
+        const st = statSync(src);
+        if (st.isDirectory()) {
+            mkdirSync(dest, { recursive: true });
+            copyTemplateTree(src, dest, vars);
+        }
+        else {
+            const raw = readFileSync(src, "utf8");
+            writeFileSync(dest, substituteVars(raw, vars), "utf8");
+        }
+    }
+}
+export function scaffoldSkill(opts) {
+    const slug = normalizeSkillSlug(opts.slug);
+    const template = normalizeTemplate(opts.template);
+    const cwd = opts.cwd ?? process.cwd();
+    const dir = resolve(cwd, `agenticros-skill-${slug}`);
+    if (existsSync(dir)) {
+        throw new Error(`Directory already exists: ${dir}`);
+    }
+    const defaults = TEMPLATE_DEFAULTS[template];
+    const displayName = slugToDisplayName(slug);
+    const toolName = slugToToolName(slug);
+    const vars = {
+        slug,
+        displayName,
+        toolName,
+        description: defaults.description,
+    };
+    const srcTemplate = join(templatesRoot(), template);
+    if (!existsSync(srcTemplate)) {
+        throw new Error(`Template not found on disk: ${srcTemplate}`);
+    }
+    mkdirSync(dir, { recursive: true });
+    copyTemplateTree(srcTemplate, dir, vars);
+    const docsDir = join(dir, "docs");
+    mkdirSync(docsDir, { recursive: true });
+    writeFileSync(join(docsDir, "icon.png"), PLACEHOLDER_PNG);
+    return { dir, slug, template, toolName };
+}
+/** SHA-256 of normalized template source (for tutorial graduation checks). */
+export function hashSkillSource(source) {
+    const normalized = source.replace(/\s+/g, " ").trim();
+    return createHash("sha256").update(normalized).digest("hex");
+}
+export function getTemplateFingerprints() {
+    const root = templatesRoot();
+    const out = {};
+    for (const t of ["hello", "robot", "camera", "depth"]) {
+        const indexPath = join(root, t, "src", "index.ts");
+        if (existsSync(indexPath)) {
+            out[t] = hashSkillSource(readFileSync(indexPath, "utf8"));
+        }
+    }
+    return out;
+}
+export function isUnmodifiedTemplate(source, template) {
+    const fps = getTemplateFingerprints();
+    const fp = fps[template];
+    if (!fp)
+        return false;
+    return hashSkillSource(source) === fp;
+}
+export function readSkillIndexSource(skillDir) {
+    const path = join(skillDir, "src", "index.ts");
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path, "utf8");
+}
+//# sourceMappingURL=skill-scaffold.js.map

package/dist/util/skill-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scaffold.js","sourceRoot":"","sources":["../../src/util/skill-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,OAAO,GAAG,mCAAmC,CAAC;AAEpD,MAAM,gBAAgB,GAAkC;IACtD,KAAK,EAAE,OAAO;IACd,CAAC,EAAE,OAAO;IACV,KAAK,EAAE,OAAO;IACd,CAAC,EAAE,OAAO;IACV,MAAM,EAAE,QAAQ;IAChB,CAAC,EAAE,QAAQ;IACX,KAAK,EAAE,OAAO;IACd,CAAC,EAAE,OAAO;CACX,CAAC;AAEF,MAAM,iBAAiB,GAGnB;IACF,KAAK,EAAE;QACL,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,0DAA0D;KACxE;IACD,KAAK,EAAE;QACL,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,mDAAmD;KACjE;IACD,MAAM,EAAE;QACN,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,0CAA0C;KACxD;IACD,KAAK,EAAE;QACL,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,gDAAgD;KAC9D;CACF,CAAC;AAEF,6DAA6D;AAC7D,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CACjC,kGAAkG,EAClG,QAAQ,CACT,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACpD,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,yCAAyC,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,IAAI,GAAG,KAAK;SACf,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,IAA4B;IACnE,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAc,EACd,OAAe,EACf,IAA4B;IAE5B,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACrC,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACtC,aAAa,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAeD,MAAM,UAAU,aAAa,CAAC,IAAqB;IACjD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAErD,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,WAAW;QACX,QAAQ;QACR,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,gBAAgB,CAAC,WAAW,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,eAAe,CAAC,CAAC;IAE1D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,EAAmC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAoB,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,QAAuB;IAEvB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,MAAM,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC;IACtB,OAAO,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticros",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "type": "module",
   "description": "AgenticROS - agentic AI for ROS-powered robots. Single CLI to launch real-robot or simulated demos, manage configuration, and inspect status.",
   "keywords": [
@@ -21,6 +21,7 @@
   },
   "files": [
     "dist",
+    "templates",
     "runtime",
     "README.md",
     "LICENSE"

package/runtime/BUNDLE.json

@@ -1,5 +1,5 @@
 {
-  "packedAt": "2026-06-16T19:04:57.796Z",
+  "packedAt": "2026-06-30T01:58:21.409Z",
   "repo": "https://github.com/PlaiPin/agenticros",
   "note": "This directory is a snapshot of the agenticros monorepo source. `agenticros init` will copy it to ~/agenticros and run pnpm install + colcon build there.",
   "layout": {

package/runtime/README.md

@@ -12,6 +12,8 @@
 
 **Physical AI Agents for ROS Robots**
 
+![AgenticROS works diagram](docs/images/works.png)
+
 [![Watch the AgenticROS intro on YouTube](https://img.youtube.com/vi/_fbWhYcPj0M/maxresdefault.jpg)](https://www.youtube.com/watch?v=_fbWhYcPj0M)
 
 > ▶ [Watch the AgenticROS intro on YouTube](https://www.youtube.com/watch?v=_fbWhYcPj0M)

package/runtime/docs/cli.md

@@ -124,6 +124,18 @@ Read or edit `~/.agenticros/config.json`. Actions:
 | `AGENTICROS_CONFIG_PATH` | (auto) | Override the path to `~/.agenticros/config.json`. |
 | `AGENTICROS_ROBOT_NAMESPACE` | (from config) | Force a robot namespace at runtime. |
 | `OPENAI_API_KEY` | (none) | If set, doctor reports green without requiring OpenClaw profile config. |
+| `AGENTICROS_SKILLS_API` | `https://skills.agenticros.com/api` | Override marketplace API base URL. |
+| `GH_TOKEN` / `GITHUB_TOKEN` | (none) | GitHub PAT for `agenticros publish`. |
+
+### Skill authoring
+
+| Command | Purpose |
+|---|---|
+| `agenticros create-skill <slug> [--template hello\|robot\|camera\|depth]` | Scaffold `./agenticros-skill-<slug>/` in cwd. |
+| `agenticros skills dev [--invoke <tool>] [--live]` | Load the skill locally without OpenClaw. |
+| `agenticros publish [--graduate]` | Validate, push to GitHub, submit to skills.agenticros.com. |
+| `agenticros skills install <owner/skill>` | Install from marketplace (e.g. `agenticros/followme`). |
+| `agenticros skills search <q>` | Search the marketplace. |
 
 ## Troubleshooting
 

package/templates/skills/camera/README.md

@@ -0,0 +1,16 @@
+# {{displayName}}
+
+{{description}}
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+## Publish
+
+```bash
+npx agenticros publish
+```

package/templates/skills/camera/demo.md

@@ -0,0 +1,5 @@
+# Prompt examples
+
+- Capture a camera frame
+- Run {{displayName}}
+- Take a snapshot from the robot camera

package/templates/skills/camera/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "agenticros-skill-{{slug}}",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "npx agenticros skills dev"
+  },
+  "agenticros": {
+    "id": "{{slug}}",
+    "displayName": "{{displayName}}",
+    "description": "{{description}}",
+    "tutorial": false,
+    "categories": ["vision"],
+    "screenshots": ["docs/icon.png"],
+    "capabilities": [
+      {
+        "id": "{{toolName}}",
+        "verb": "capture",
+        "description": "{{description}}"
+      }
+    ]
+  },
+  "dependencies": {
+    "@agenticros/core": "^0.5.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["agenticros", "camera", "vision"],
+  "license": "Apache-2.0"
+}

package/templates/skills/camera/src/index.ts

@@ -0,0 +1,68 @@
+/**
+ * {{displayName}} — capture one frame from the robot camera.
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { RosTransport } from "@agenticros/core";
+
+const TOOL_NAME = "{{toolName}}";
+
+interface SkillContext {
+  getTransport(): RosTransport;
+}
+
+interface SkillPluginApi {
+  registerTool(tool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (
+      toolCallId: string,
+      params: Record<string, unknown>,
+      signal?: AbortSignal,
+    ) => Promise<{ content: { type: string; text: string }[]; details?: unknown }>;
+  }): void;
+}
+
+export function registerSkill(
+  api: SkillPluginApi,
+  config: { robot?: { cameraTopic?: string } },
+  context: SkillContext,
+): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({
+      topic: Type.Optional(
+        Type.String({ description: "Camera topic override (default from robot config)." }),
+      ),
+    }),
+    async execute(_id, params) {
+      const transport = context.getTransport();
+      const topic =
+        (typeof params.topic === "string" && params.topic) ||
+        config.robot?.cameraTopic ||
+        "camera/color/image_raw";
+      const msg = await transport.subscribeOnce(topic, 5000);
+      const encoding =
+        msg && typeof msg === "object" && "encoding" in msg
+          ? String((msg as { encoding?: string }).encoding ?? "unknown")
+          : "unknown";
+      const width =
+        msg && typeof msg === "object" && "width" in msg
+          ? Number((msg as { width?: number }).width ?? 0)
+          : 0;
+      const height =
+        msg && typeof msg === "object" && "height" in msg
+          ? Number((msg as { height?: number }).height ?? 0)
+          : 0;
+      const summary = `Captured ${width}x${height} frame (${encoding}) from ${topic}.`;
+      return {
+        content: [{ type: "text", text: summary }],
+        details: { topic, width, height, encoding, captured: Boolean(msg) },
+      };
+    },
+  });
+}

package/templates/skills/camera/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}

package/templates/skills/depth/README.md

@@ -0,0 +1,16 @@
+# {{displayName}}
+
+{{description}}
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+## Publish
+
+```bash
+npx agenticros publish
+```

package/templates/skills/depth/demo.md

@@ -0,0 +1,5 @@
+# Prompt examples
+
+- Measure distance to the object in front of the robot
+- Run {{displayName}}
+- How far away is the obstacle?

package/templates/skills/depth/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "agenticros-skill-{{slug}}",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "npx agenticros skills dev"
+  },
+  "agenticros": {
+    "id": "{{slug}}",
+    "displayName": "{{displayName}}",
+    "description": "{{description}}",
+    "tutorial": false,
+    "categories": ["vision", "telemetry"],
+    "screenshots": ["docs/icon.png"],
+    "capabilities": [
+      {
+        "id": "{{toolName}}",
+        "verb": "measure",
+        "description": "{{description}}"
+      }
+    ]
+  },
+  "dependencies": {
+    "@agenticros/core": "^0.5.0",
+    "@sinclair/typebox": "^0.34.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["agenticros", "depth", "realsense"],
+  "license": "Apache-2.0"
+}

package/templates/skills/depth/src/index.ts

@@ -0,0 +1,69 @@
+/**
+ * {{displayName}} — sample depth at image center (RealSense / depth camera).
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { RosTransport } from "@agenticros/core";
+
+const TOOL_NAME = "{{toolName}}";
+
+interface DepthSampleResult {
+  distance_m: number;
+  valid: boolean;
+  topic: string;
+}
+
+interface SkillContext {
+  getTransport(): RosTransport;
+  getDepthDistance(
+    transport: RosTransport,
+    topic: string,
+    timeoutMs?: number,
+  ): Promise<DepthSampleResult>;
+}
+
+interface SkillPluginApi {
+  registerTool(tool: {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (
+      toolCallId: string,
+      params: Record<string, unknown>,
+      signal?: AbortSignal,
+    ) => Promise<{ content: { type: string; text: string }[]; details?: unknown }>;
+  }): void;
+}
+
+export function registerSkill(
+  api: SkillPluginApi,
+  config: { robot?: { depthTopic?: string } },
+  context: SkillContext,
+): void {
+  api.registerTool({
+    name: TOOL_NAME,
+    label: "{{displayName}}",
+    description: "{{description}}",
+    parameters: Type.Object({
+      topic: Type.Optional(
+        Type.String({ description: "Depth topic override (default: depth/image_rect_raw)." }),
+      ),
+    }),
+    async execute(_id, params) {
+      const transport = context.getTransport();
+      const topic =
+        (typeof params.topic === "string" && params.topic) ||
+        config.robot?.depthTopic ||
+        "depth/image_rect_raw";
+      const sample = await context.getDepthDistance(transport, topic, 5000);
+      const text = sample.valid
+        ? `Object is ${sample.distance_m.toFixed(1)} meters away.`
+        : `No valid depth reading on ${topic}.`;
+      return {
+        content: [{ type: "text", text }],
+        details: sample,
+      };
+    },
+  });
+}

package/templates/skills/depth/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}

package/templates/skills/hello/README.md

@@ -0,0 +1,32 @@
+# {{displayName}}
+
+{{description}}
+
+> **Tutorial skill** — meant for local learning with `npm run dev`. Customize the code or scaffold with `--template robot` before publishing to the marketplace.
+
+## Local dev
+
+```bash
+npm install
+npm run dev
+```
+
+## Invoke (OpenClaw / Claude / Gemini)
+
+After registering with your gateway:
+
+```bash
+agenticros skills add .
+agenticros skills sync
+# restart gateway
+```
+
+Try prompts from [demo.md](./demo.md).
+
+## Publish
+
+```bash
+npx agenticros publish
+```
+
+Tutorial skills stay unlisted on [skills.agenticros.com](https://skills.agenticros.com) unless you customize and use `--graduate`.