@olegkoval/agent-skills 1.0.0-beta.1

package/scripts/build-adapters.sh

@@ -0,0 +1,115 @@
+#!/bin/sh
+set -eu
+
+node <<'EOF'
+const fs = require('fs')
+const path = require('path')
+
+const root = process.cwd()
+const catalogPath = path.join(root, 'catalog', 'skills.json')
+const catalog = JSON.parse(fs.readFileSync(catalogPath, 'utf8'))
+const projectName = catalog.name
+const lookupNameFor = (pkg) => pkg.lookupName || pkg.name
+const skillPathFor = (pkg) => path.join(root, pkg.path, 'SKILL.md')
+const promptNameFor = (pkg) => `${pkg.name}.prompt.md`
+const generatedHeader = '<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->'
+const stripFrontmatter = (content) => content.replace(/^---\n[\s\S]*?\n---\n?/, '')
+const stripTrailingLineWhitespace = (content) => content.replace(/[ \t]+$/gm, '')
+
+const plugins = catalog.packages.map((pkg) => ({
+  name: lookupNameFor(pkg),
+  source: `./${pkg.path}/adapters/claude`,
+  description: pkg.description,
+}))
+
+const cursorPlugins = catalog.packages.map((pkg) => ({
+  name: lookupNameFor(pkg),
+  source: `./${pkg.path}/adapters/cursor`,
+  description: pkg.description,
+}))
+
+fs.mkdirSync(path.join(root, '.claude-plugin'), { recursive: true })
+fs.mkdirSync(path.join(root, '.cursor-plugin'), { recursive: true })
+fs.mkdirSync(path.join(root, '.github', 'prompts'), { recursive: true })
+
+fs.writeFileSync(
+  path.join(root, '.claude-plugin', 'marketplace.json'),
+  JSON.stringify(
+    {
+      name: projectName,
+      owner: { name: 'Oleg Koval' },
+      plugins,
+    },
+    null,
+    2,
+  ) + '\n',
+)
+
+fs.writeFileSync(
+  path.join(root, '.cursor-plugin', 'index.json'),
+  JSON.stringify(
+    {
+      name: projectName,
+      plugins: cursorPlugins,
+    },
+    null,
+    2,
+  ) + '\n',
+)
+
+const copilotInstructions = [
+  generatedHeader,
+  '',
+  '# Agent Skills Repository Instructions',
+  '',
+  'This repository is an opinionated agent skill catalog. Skills encode concrete defaults, preferred tools, and repeatable workflows.',
+  '',
+  '- Treat `catalog/skills.json` as the source of truth for package metadata.',
+  '- Keep canonical skill instructions in `packages/{category}/{skill}/SKILL.md`.',
+  '- Keep generated adapter files in sync by running `./scripts/build-adapters.sh` after catalog or skill metadata changes (includes Cursor `skills/*/SKILL.md` copies from each canonical `SKILL.md`).',
+  '- Run `./scripts/validate-catalog.sh` before release.',
+  '- Prefer small, scoped updates that preserve existing package structure.',
+  '',
+  'Available reusable prompt files:',
+  ...catalog.packages.map((pkg) => `- ${pkg.name}: .github/prompts/${promptNameFor(pkg)}`),
+  '',
+].join('\n')
+
+fs.writeFileSync(path.join(root, '.github', 'copilot-instructions.md'), copilotInstructions)
+
+for (const pkg of catalog.packages) {
+  if (!pkg.adapters.includes('copilot')) {
+    continue
+  }
+
+  const skillBody = stripFrontmatter(fs.readFileSync(skillPathFor(pkg), 'utf8')).trimEnd()
+  const prompt = stripTrailingLineWhitespace([
+    generatedHeader,
+    '',
+    '---',
+    `description: ${JSON.stringify(pkg.description)}`,
+    '---',
+    '',
+    `Use the ${lookupNameFor(pkg)} skill.`,
+    '',
+    skillBody,
+    '',
+  ].join('\n'))
+
+  fs.writeFileSync(path.join(root, '.github', 'prompts', promptNameFor(pkg)), prompt)
+}
+
+for (const pkg of catalog.packages) {
+  if (!pkg.adapters.includes('cursor')) {
+    continue
+  }
+
+  const canonical = fs.readFileSync(skillPathFor(pkg), 'utf8').trimEnd()
+  const destDir = path.join(root, pkg.path, 'adapters', 'cursor', 'skills', pkg.name)
+  const destPath = path.join(destDir, 'SKILL.md')
+  fs.mkdirSync(destDir, { recursive: true })
+  fs.writeFileSync(destPath, [generatedHeader, '', canonical, ''].join('\n'))
+}
+
+console.log('generated marketplace manifests, Copilot prompts, and Cursor adapter SKILL.md files')
+EOF

package/scripts/install-codex-symlinks.sh

@@ -0,0 +1,37 @@
+#!/bin/sh
+set -eu
+
+CODEX_SKILLS_DIR="${CODEX_HOME:-$HOME/.codex}/skills"
+ROOT="$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)"
+CATALOG="$ROOT/catalog/skills.json"
+
+mkdir -p "$CODEX_SKILLS_DIR"
+
+node - "$CATALOG" "$ROOT" "$CODEX_SKILLS_DIR" <<'EOF'
+const fs = require('fs')
+const path = require('path')
+
+const [, , catalogPath, root, codexSkillsDir] = process.argv
+const catalog = JSON.parse(fs.readFileSync(catalogPath, 'utf8'))
+
+for (const pkg of catalog.packages) {
+  const target = path.join(root, pkg.path)
+  const lookupName = pkg.lookupName || `olko:${pkg.name}`
+  const linkPath = path.join(codexSkillsDir, lookupName)
+
+  try {
+    const stat = fs.lstatSync(linkPath)
+    if (!stat.isSymbolicLink()) {
+      throw new Error(`${linkPath} exists and is not a symlink`)
+    }
+    fs.unlinkSync(linkPath)
+  } catch (error) {
+    if (error.code !== 'ENOENT') {
+      throw error
+    }
+  }
+
+  fs.symlinkSync(target, linkPath, 'dir')
+  console.log(`linked ${lookupName} -> ${target}`)
+}
+EOF

package/scripts/sync-from-sources.sh

@@ -0,0 +1,44 @@
+#!/bin/sh
+set -eu
+
+node <<'EOF'
+const fs = require('fs')
+const path = require('path')
+
+const root = process.cwd()
+const catalog = JSON.parse(fs.readFileSync(path.join(root, 'catalog', 'skills.json'), 'utf8'))
+let synced = 0
+
+const copyIfPresent = (source, target) => {
+  if (!fs.existsSync(source)) {
+    return
+  }
+
+  fs.rmSync(target, { force: true, recursive: true })
+  fs.cpSync(source, target, { recursive: true })
+}
+
+for (const pkg of catalog.packages) {
+  if (!pkg.sourcePath) {
+    continue
+  }
+
+  const sourcePath = path.resolve(root, pkg.sourcePath)
+  const targetPath = path.resolve(root, pkg.path)
+
+  if (!fs.existsSync(sourcePath)) {
+    throw new Error(`sourcePath for ${pkg.name} does not exist: ${pkg.sourcePath}`)
+  }
+
+  fs.mkdirSync(targetPath, { recursive: true })
+  copyIfPresent(path.join(sourcePath, 'SKILL.md'), path.join(targetPath, 'SKILL.md'))
+  copyIfPresent(path.join(sourcePath, 'references'), path.join(targetPath, 'references'))
+  copyIfPresent(path.join(sourcePath, 'LICENSE'), path.join(targetPath, 'LICENSE'))
+  synced += 1
+  console.log(`synced ${pkg.name} from ${pkg.sourcePath}`)
+}
+
+if (synced === 0) {
+  console.log('no package sourcePath entries configured; nothing to sync')
+}
+EOF

package/scripts/validate-catalog.sh

@@ -0,0 +1,90 @@
+#!/bin/sh
+set -eu
+
+test -f catalog/skills.json
+test -f collections/software-development.json
+test -f collections/marketing.json
+test -f collections/music.json
+test -f collections/photography.json
+test -f collections/docs-tools.json
+test -f collections/release-tools.json
+test -f .claude-plugin/marketplace.json
+test -f .cursor-plugin/index.json
+test -f .github/copilot-instructions.md
+
+node <<'EOF'
+const fs = require('fs')
+const path = require('path')
+
+const categories = new Set(['software-development', 'marketing', 'music', 'photography'])
+const adapterFiles = {
+  claude: (pkg) => path.join(pkg.path, 'adapters', 'claude', 'plugin.json'),
+  codex: (pkg) => path.join(pkg.path, 'adapters', 'codex', 'README.md'),
+  cursor: (pkg) => path.join(pkg.path, 'adapters', 'cursor', 'plugin.json'),
+  copilot: (pkg) => path.join('.github', 'prompts', `${pkg.name}.prompt.md`),
+}
+
+const catalog = JSON.parse(fs.readFileSync('catalog/skills.json', 'utf8'))
+const packagesByName = new Map(catalog.packages.map((pkg) => [pkg.name, pkg]))
+const claudeManifest = JSON.parse(fs.readFileSync('.claude-plugin/marketplace.json', 'utf8'))
+const cursorManifest = JSON.parse(fs.readFileSync('.cursor-plugin/index.json', 'utf8'))
+
+for (const pkg of catalog.packages) {
+  if (!pkg.name || !pkg.lookupName || !pkg.path || !pkg.description) {
+    throw new Error(`package metadata is incomplete: ${JSON.stringify(pkg)}`)
+  }
+
+  if (!categories.has(pkg.category)) {
+    throw new Error(`unknown category for ${pkg.name}: ${pkg.category}`)
+  }
+
+  const skillPath = path.join(pkg.path, 'SKILL.md')
+  if (!fs.existsSync(skillPath)) {
+    throw new Error(`missing SKILL.md for ${pkg.name}: ${skillPath}`)
+  }
+
+  for (const adapter of pkg.adapters || []) {
+    const adapterFileFor = adapterFiles[adapter]
+    if (!adapterFileFor) {
+      throw new Error(`unknown adapter for ${pkg.name}: ${adapter}`)
+    }
+
+    const adapterFile = adapterFileFor(pkg)
+    if (!fs.existsSync(adapterFile)) {
+      throw new Error(`missing ${adapter} adapter for ${pkg.name}: ${adapterFile}`)
+    }
+  }
+}
+
+for (const collectionPath of fs.readdirSync('collections').map((name) => path.join('collections', name))) {
+  const collection = JSON.parse(fs.readFileSync(collectionPath, 'utf8'))
+  for (const packageName of collection.packages || []) {
+    if (!packagesByName.has(packageName)) {
+      throw new Error(`${collectionPath} references unknown package: ${packageName}`)
+    }
+  }
+}
+
+for (const plugin of claudeManifest.plugins || []) {
+  const source = plugin.source.replace(/^\.\//, '')
+  if (!fs.existsSync(source)) {
+    throw new Error(`Claude manifest source does not exist: ${plugin.source}`)
+  }
+}
+
+for (const plugin of cursorManifest.plugins || []) {
+  const source = plugin.source.replace(/^\.\//, '')
+  if (!fs.existsSync(source)) {
+    throw new Error(`Cursor manifest source does not exist: ${plugin.source}`)
+  }
+}
+
+for (const pkg of catalog.packages) {
+  const oldFlatPath = path.join('packages', pkg.name, 'SKILL.md')
+  if (fs.existsSync(oldFlatPath)) {
+    throw new Error(`stale flat package path exists: ${oldFlatPath}`)
+  }
+}
+EOF
+
+echo "catalog validation passed"