@dzhechkov/harness-core 0.3.16 → 0.3.17

package/dist/import-ecc.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `dz import-ecc` — import skills from the ECC project (https://github.com/affaan-m/ECC).
+ *
+ * Fetches SKILL.md files from ECC's GitHub repo, maps the frontmatter to
+ * agentskills.io format, deduplicates against existing skills, and writes
+ * the imported skills to the target directory.
+ *
+ * @packageDocumentation
+ */
+/** Result of a single skill import. */
+export interface ImportedSkill {
+    readonly id: string;
+    readonly status: 'imported' | 'skipped_duplicate' | 'skipped_error';
+    readonly reason?: string;
+}
+/** Full import report. */
+export interface ImportEccReport {
+    readonly source: string;
+    readonly totalFetched: number;
+    readonly imported: number;
+    readonly skippedDuplicate: number;
+    readonly skippedError: number;
+    readonly skills: readonly ImportedSkill[];
+}
+/** Options for the import. */
+export interface ImportEccOptions {
+    /** Directory containing existing skills to check for duplicates. */
+    readonly existingSkillsDir: string;
+    /** Directory to write imported skills into. */
+    readonly outputDir: string;
+    /** If true, overwrite existing skills. */
+    readonly force?: boolean;
+    /** Only import these skill IDs (filter). */
+    readonly select?: readonly string[];
+    /** Maximum number of skills to import (default: all). */
+    readonly limit?: number;
+    /** Path to a local ECC clone (skip GitHub fetch). */
+    readonly localPath?: string;
+}
+/**
+ * Import skills from ECC.
+ *
+ * Supports two modes:
+ * 1. Local clone: `--local-path /path/to/ECC` (fast, no network)
+ * 2. GitHub API: fetches from api.github.com (rate-limited, requires no clone)
+ */
+export declare function importEcc(options: ImportEccOptions): Promise<ImportEccReport>;
+//# sourceMappingURL=import-ecc.d.ts.map

package/dist/import-ecc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-ecc.d.ts","sourceRoot":"","sources":["../src/import-ecc.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,GAAG,eAAe,CAAC;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED,8BAA8B;AAC9B,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6ED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0FnF"}

package/dist/import-ecc.js

@@ -0,0 +1,171 @@
+/**
+ * `dz import-ecc` — import skills from the ECC project (https://github.com/affaan-m/ECC).
+ *
+ * Fetches SKILL.md files from ECC's GitHub repo, maps the frontmatter to
+ * agentskills.io format, deduplicates against existing skills, and writes
+ * the imported skills to the target directory.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, mkdirSync, writeFileSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const ECC_SKILLS_API = 'https://api.github.com/repos/affaan-m/ECC/contents/skills';
+const ECC_RAW_BASE = 'https://raw.githubusercontent.com/affaan-m/ECC/main/skills';
+/**
+ * Map ECC YAML frontmatter to agentskills.io format.
+ *
+ * ECC format:
+ * ```yaml
+ * name: skill-name
+ * description: long description
+ * origin: ECC
+ * tools: Read, Write, Bash
+ * ```
+ *
+ * agentskills.io format:
+ * ```yaml
+ * name: skill-name
+ * description: long description
+ * trust_tier: 0
+ * trust_tier_label: "Community (imported from ECC)"
+ * ```
+ */
+function mapFrontmatter(eccContent) {
+    // Extract frontmatter
+    const fmMatch = eccContent.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+    if (!fmMatch)
+        return eccContent; // No frontmatter — return as-is
+    const fmYaml = fmMatch[1] ?? '';
+    const body = eccContent.slice(fmMatch[0]?.length ?? 0);
+    // Parse fields from YAML (simple key: value parsing, no library needed)
+    const nameMatch = fmYaml.match(/^name:\s*(.+)$/m);
+    const descMatch = fmYaml.match(/^description:\s*([\s\S]*?)(?=\n\w+:|$)/m);
+    const name = nameMatch?.[1]?.trim() ?? 'unknown';
+    let desc = descMatch?.[1]?.trim() ?? '';
+    // Collapse multi-line description
+    desc = desc.replace(/\n\s+/g, ' ');
+    // Build agentskills.io frontmatter
+    const newFm = [
+        '---',
+        `name: "${name}"`,
+        `description: >`,
+        `  ${desc}`,
+        `trust_tier: 0`,
+        `trust_tier_label: "Community (imported from ECC)"`,
+        `source: "https://github.com/affaan-m/ECC/tree/main/skills/${name}"`,
+        '---',
+    ].join('\n');
+    return newFm + '\n' + body;
+}
+/**
+ * List ECC skill directories from a local clone.
+ */
+function listLocalSkills(localPath) {
+    const skillsDir = join(localPath, 'skills');
+    if (!existsSync(skillsDir))
+        return [];
+    return readdirSync(skillsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name)
+        .sort();
+}
+/**
+ * Read a skill from a local ECC clone.
+ */
+function readLocalSkill(localPath, skillId) {
+    const skillMd = join(localPath, 'skills', skillId, 'SKILL.md');
+    if (!existsSync(skillMd))
+        return null;
+    return readFileSync(skillMd, 'utf-8');
+}
+/**
+ * Import skills from ECC.
+ *
+ * Supports two modes:
+ * 1. Local clone: `--local-path /path/to/ECC` (fast, no network)
+ * 2. GitHub API: fetches from api.github.com (rate-limited, requires no clone)
+ */
+export async function importEcc(options) {
+    const existing = new Set();
+    if (existsSync(options.existingSkillsDir)) {
+        for (const d of readdirSync(options.existingSkillsDir, { withFileTypes: true })) {
+            if (d.isDirectory())
+                existing.add(d.name);
+        }
+    }
+    let skillIds;
+    if (options.localPath) {
+        // Local clone mode
+        skillIds = listLocalSkills(options.localPath);
+    }
+    else {
+        // GitHub API mode — fetch directory listing
+        const res = await fetch(ECC_SKILLS_API, {
+            headers: { 'Accept': 'application/vnd.github.v3+json', 'User-Agent': 'dz-harness-hub' },
+        });
+        if (!res.ok) {
+            return {
+                source: 'github.com/affaan-m/ECC',
+                totalFetched: 0, imported: 0, skippedDuplicate: 0, skippedError: 1,
+                skills: [{ id: 'api', status: 'skipped_error', reason: `GitHub API ${res.status}: ${res.statusText}` }],
+            };
+        }
+        const entries = (await res.json());
+        skillIds = entries.filter((e) => e.type === 'dir').map((e) => e.name).sort();
+    }
+    // Apply filters
+    if (options.select) {
+        const sel = new Set(options.select);
+        skillIds = skillIds.filter((id) => sel.has(id));
+    }
+    if (options.limit) {
+        skillIds = skillIds.slice(0, options.limit);
+    }
+    const results = [];
+    for (const id of skillIds) {
+        // Check for duplicates
+        if (existing.has(id) && !options.force) {
+            results.push({ id, status: 'skipped_duplicate', reason: `Already exists in ${options.existingSkillsDir}` });
+            continue;
+        }
+        try {
+            let content;
+            if (options.localPath) {
+                content = readLocalSkill(options.localPath, id);
+            }
+            else {
+                // Fetch from GitHub raw
+                const url = `${ECC_RAW_BASE}/${id}/SKILL.md`;
+                const res = await fetch(url, { headers: { 'User-Agent': 'dz-harness-hub' } });
+                if (!res.ok) {
+                    results.push({ id, status: 'skipped_error', reason: `HTTP ${res.status}` });
+                    continue;
+                }
+                content = await res.text();
+            }
+            if (!content) {
+                results.push({ id, status: 'skipped_error', reason: 'No SKILL.md found' });
+                continue;
+            }
+            // Map frontmatter
+            const mapped = mapFrontmatter(content);
+            // Write to output directory
+            const outDir = join(options.outputDir, id);
+            mkdirSync(outDir, { recursive: true });
+            writeFileSync(join(outDir, 'SKILL.md'), mapped, 'utf-8');
+            results.push({ id, status: 'imported' });
+        }
+        catch (err) {
+            results.push({ id, status: 'skipped_error', reason: String(err) });
+        }
+    }
+    return {
+        source: options.localPath ?? 'github.com/affaan-m/ECC',
+        totalFetched: skillIds.length,
+        imported: results.filter((r) => r.status === 'imported').length,
+        skippedDuplicate: results.filter((r) => r.status === 'skipped_duplicate').length,
+        skippedError: results.filter((r) => r.status === 'skipped_error').length,
+        skills: results,
+    };
+}
+//# sourceMappingURL=import-ecc.js.map

package/dist/import-ecc.js.map

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

package/dist/index.d.ts

@@ -32,6 +32,8 @@ export type { InstalledSkill, UpgradeCheck, UpgradeReport } from './upgrade.js';
 export type { PublishResult, PublishReport } from './publish.js';
 export { computeRiskScore } from './risk-scoring.js';
 export type { RiskScore, RiskThresholds } from './risk-scoring.js';
+export { importEcc } from './import-ecc.js';
+export type { ImportEccReport, ImportEccOptions, ImportedSkill } from './import-ecc.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -22,4 +22,5 @@ export { discoverPackages, publishPackages } from './publish.js';
 export { fetchAllDownloads } from './downloads.js';
 export { discoverInstalled, checkUpgrades } from './upgrade.js';
 export { computeRiskScore } from './risk-scoring.js';
+export { importEcc } from './import-ecc.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",

package/src/import-ecc.ts

@@ -0,0 +1,219 @@
+/**
+ * `dz import-ecc` — import skills from the ECC project (https://github.com/affaan-m/ECC).
+ *
+ * Fetches SKILL.md files from ECC's GitHub repo, maps the frontmatter to
+ * agentskills.io format, deduplicates against existing skills, and writes
+ * the imported skills to the target directory.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, mkdirSync, writeFileSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Result of a single skill import. */
+export interface ImportedSkill {
+  readonly id: string;
+  readonly status: 'imported' | 'skipped_duplicate' | 'skipped_error';
+  readonly reason?: string;
+}
+
+/** Full import report. */
+export interface ImportEccReport {
+  readonly source: string;
+  readonly totalFetched: number;
+  readonly imported: number;
+  readonly skippedDuplicate: number;
+  readonly skippedError: number;
+  readonly skills: readonly ImportedSkill[];
+}
+
+/** Options for the import. */
+export interface ImportEccOptions {
+  /** Directory containing existing skills to check for duplicates. */
+  readonly existingSkillsDir: string;
+  /** Directory to write imported skills into. */
+  readonly outputDir: string;
+  /** If true, overwrite existing skills. */
+  readonly force?: boolean;
+  /** Only import these skill IDs (filter). */
+  readonly select?: readonly string[];
+  /** Maximum number of skills to import (default: all). */
+  readonly limit?: number;
+  /** Path to a local ECC clone (skip GitHub fetch). */
+  readonly localPath?: string;
+}
+
+const ECC_SKILLS_API = 'https://api.github.com/repos/affaan-m/ECC/contents/skills';
+const ECC_RAW_BASE = 'https://raw.githubusercontent.com/affaan-m/ECC/main/skills';
+
+/**
+ * Map ECC YAML frontmatter to agentskills.io format.
+ *
+ * ECC format:
+ * ```yaml
+ * name: skill-name
+ * description: long description
+ * origin: ECC
+ * tools: Read, Write, Bash
+ * ```
+ *
+ * agentskills.io format:
+ * ```yaml
+ * name: skill-name
+ * description: long description
+ * trust_tier: 0
+ * trust_tier_label: "Community (imported from ECC)"
+ * ```
+ */
+function mapFrontmatter(eccContent: string): string {
+  // Extract frontmatter
+  const fmMatch = eccContent.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  if (!fmMatch) return eccContent; // No frontmatter — return as-is
+
+  const fmYaml = fmMatch[1] ?? '';
+  const body = eccContent.slice(fmMatch[0]?.length ?? 0);
+
+  // Parse fields from YAML (simple key: value parsing, no library needed)
+  const nameMatch = fmYaml.match(/^name:\s*(.+)$/m);
+  const descMatch = fmYaml.match(/^description:\s*([\s\S]*?)(?=\n\w+:|$)/m);
+
+  const name = nameMatch?.[1]?.trim() ?? 'unknown';
+  let desc = descMatch?.[1]?.trim() ?? '';
+  // Collapse multi-line description
+  desc = desc.replace(/\n\s+/g, ' ');
+
+  // Build agentskills.io frontmatter
+  const newFm = [
+    '---',
+    `name: "${name}"`,
+    `description: >`,
+    `  ${desc}`,
+    `trust_tier: 0`,
+    `trust_tier_label: "Community (imported from ECC)"`,
+    `source: "https://github.com/affaan-m/ECC/tree/main/skills/${name}"`,
+    '---',
+  ].join('\n');
+
+  return newFm + '\n' + body;
+}
+
+/**
+ * List ECC skill directories from a local clone.
+ */
+function listLocalSkills(localPath: string): string[] {
+  const skillsDir = join(localPath, 'skills');
+  if (!existsSync(skillsDir)) return [];
+  return readdirSync(skillsDir, { withFileTypes: true })
+    .filter((d) => d.isDirectory())
+    .map((d) => d.name)
+    .sort();
+}
+
+/**
+ * Read a skill from a local ECC clone.
+ */
+function readLocalSkill(localPath: string, skillId: string): string | null {
+  const skillMd = join(localPath, 'skills', skillId, 'SKILL.md');
+  if (!existsSync(skillMd)) return null;
+  return readFileSync(skillMd, 'utf-8');
+}
+
+/**
+ * Import skills from ECC.
+ *
+ * Supports two modes:
+ * 1. Local clone: `--local-path /path/to/ECC` (fast, no network)
+ * 2. GitHub API: fetches from api.github.com (rate-limited, requires no clone)
+ */
+export async function importEcc(options: ImportEccOptions): Promise<ImportEccReport> {
+  const existing = new Set<string>();
+  if (existsSync(options.existingSkillsDir)) {
+    for (const d of readdirSync(options.existingSkillsDir, { withFileTypes: true })) {
+      if (d.isDirectory()) existing.add(d.name);
+    }
+  }
+
+  let skillIds: string[];
+
+  if (options.localPath) {
+    // Local clone mode
+    skillIds = listLocalSkills(options.localPath);
+  } else {
+    // GitHub API mode — fetch directory listing
+    const res = await fetch(ECC_SKILLS_API, {
+      headers: { 'Accept': 'application/vnd.github.v3+json', 'User-Agent': 'dz-harness-hub' },
+    });
+    if (!res.ok) {
+      return {
+        source: 'github.com/affaan-m/ECC',
+        totalFetched: 0, imported: 0, skippedDuplicate: 0, skippedError: 1,
+        skills: [{ id: 'api', status: 'skipped_error', reason: `GitHub API ${res.status}: ${res.statusText}` }],
+      };
+    }
+    const entries = (await res.json()) as { name: string; type: string }[];
+    skillIds = entries.filter((e) => e.type === 'dir').map((e) => e.name).sort();
+  }
+
+  // Apply filters
+  if (options.select) {
+    const sel = new Set(options.select);
+    skillIds = skillIds.filter((id) => sel.has(id));
+  }
+  if (options.limit) {
+    skillIds = skillIds.slice(0, options.limit);
+  }
+
+  const results: ImportedSkill[] = [];
+
+  for (const id of skillIds) {
+    // Check for duplicates
+    if (existing.has(id) && !options.force) {
+      results.push({ id, status: 'skipped_duplicate', reason: `Already exists in ${options.existingSkillsDir}` });
+      continue;
+    }
+
+    try {
+      let content: string | null;
+
+      if (options.localPath) {
+        content = readLocalSkill(options.localPath, id);
+      } else {
+        // Fetch from GitHub raw
+        const url = `${ECC_RAW_BASE}/${id}/SKILL.md`;
+        const res = await fetch(url, { headers: { 'User-Agent': 'dz-harness-hub' } });
+        if (!res.ok) {
+          results.push({ id, status: 'skipped_error', reason: `HTTP ${res.status}` });
+          continue;
+        }
+        content = await res.text();
+      }
+
+      if (!content) {
+        results.push({ id, status: 'skipped_error', reason: 'No SKILL.md found' });
+        continue;
+      }
+
+      // Map frontmatter
+      const mapped = mapFrontmatter(content);
+
+      // Write to output directory
+      const outDir = join(options.outputDir, id);
+      mkdirSync(outDir, { recursive: true });
+      writeFileSync(join(outDir, 'SKILL.md'), mapped, 'utf-8');
+
+      results.push({ id, status: 'imported' });
+    } catch (err) {
+      results.push({ id, status: 'skipped_error', reason: String(err) });
+    }
+  }
+
+  return {
+    source: options.localPath ?? 'github.com/affaan-m/ECC',
+    totalFetched: skillIds.length,
+    imported: results.filter((r) => r.status === 'imported').length,
+    skippedDuplicate: results.filter((r) => r.status === 'skipped_duplicate').length,
+    skippedError: results.filter((r) => r.status === 'skipped_error').length,
+    skills: results,
+  };
+}

package/src/index.ts

@@ -34,5 +34,7 @@ export type { InstalledSkill, UpgradeCheck, UpgradeReport } from './upgrade.js';
 export type { PublishResult, PublishReport } from './publish.js';
 export { computeRiskScore } from './risk-scoring.js';
 export type { RiskScore, RiskThresholds } from './risk-scoring.js';
+export { importEcc } from './import-ecc.js';
+export type { ImportEccReport, ImportEccOptions, ImportedSkill } from './import-ecc.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';