@opendirectory.dev/skills 0.1.72 → 0.1.73

package/README.md

@@ -0,0 +1,19 @@
+# @opendirectory.dev/skills
+
+The official CLI for installing and managing OpenDirectory skills for AI agents (Claude, Cursor, etc.).
+
+## Installation & Usage
+
+You don't need to install this package globally. You can run it directly using `npx`:
+
+```bash
+npx "@opendirectory.dev/skills" install <skill-name> --target claude
+```
+
+## Available Skills
+
+For the full list of available skills, detailed documentation, and contribution guidelines, please visit the [OpenDirectory GitHub Repository](https://github.com/Varnan-Tech/opendirectory).
+
+## License
+
+MIT

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@opendirectory.dev/skills",
-  "version": "0.1.72",
+  "version": "0.1.73",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "skills",
+    "registry.json"
+  ],
   "bin": {
     "opendirectory": "dist/index.js"
   },

package/.claude/skills/claude-md-generator/.env.example

@@ -1,7 +0,0 @@
-# claude-md-generator — Environment Variables
-# =============================================
-# Gemini is required for generating the CLAUDE.md content from analysis.
-
-# Required: Google Gemini API key for CLAUDE.md generation
-# Get it: aistudio.google.com, Get API key
-GEMINI_API_KEY=your_gemini_api_key_here

package/.claude/skills/claude-md-generator/README.md

@@ -1,78 +0,0 @@
-# claude-md-generator
-
-<img width="1280" height="640" alt="claude-md-generator" src="https://github.com/user-attachments/assets/0e295271-2216-47f7-828f-845c98ef0298" />
-
-
-Reads your codebase and writes a CLAUDE.md that gives Claude Code the context it needs: build commands, code conventions, architecture notes, and gotchas. Stays under 200 lines.
-
-## What It Does
-
-- Scans project files: package.json, tsconfig.json, linter configs, Makefile, directory structure
-- Extracts all build, test, lint, and dev commands
-- Identifies code style conventions that differ from defaults (path aliases, export patterns, naming)
-- Maps non-obvious architecture decisions
-- Finds gotchas: auto-generated files, required env var setup, test dependencies
-- Generates CLAUDE.md using Gemini, then verifies it stays under 200 lines
-- If CLAUDE.md already exists, improves it without discarding custom content
-
-## Requirements
-
-| Requirement | Purpose | How to Set Up |
-|------------|---------|--------------|
-| Gemini API key | CLAUDE.md generation from codebase analysis | aistudio.google.com, Get API key |
-
-## Setup
-
-```bash
-cp .env.example .env
-# Add GEMINI_API_KEY
-```
-
-## How to Use
-
-From the project root you want to document:
-```
-"Generate a CLAUDE.md for this project"
-"Create a CLAUDE.md"
-"Write Claude configuration for this repo"
-"Help Claude understand this codebase"
-```
-
-To update an existing CLAUDE.md:
-```
-"Update my CLAUDE.md: we added Vitest and changed the build system"
-"Improve my existing CLAUDE.md"
-```
-
-## What Goes in CLAUDE.md
-
-| Section | Include | Skip |
-|---------|---------|------|
-| Commands | Exact runnable commands, flags needed, env vars required | `npm install` and other obvious ones |
-| Architecture | Non-obvious structure, auto-generated directories | "src contains source files" |
-| Code Style | Path aliases, export conventions, non-default settings | Indent size (formatter handles it) |
-| Testing | Required setup, how to run one test | "we use Jest" (visible from package.json) |
-| Gotchas | Auto-generated files, env var order, known intentional issues | Things derivable from the code |
-
-## Why Under 200 Lines
-
-Long CLAUDE.md files get ignored. Claude loads the full file into context every session: a bloated CLAUDE.md with obvious content trains Claude to skim it. A tight 100-150 line CLAUDE.md with only non-obvious facts gets read and used.
-
-The skill cuts aggressively: if a section says only things Claude can infer from the code, it removes it.
-
-## Project Structure
-
-```
-claude-md-generator/
-├── SKILL.md
-├── README.md
-├── .env.example
-├── evals/
-│   └── evals.json
-└── references/
-    └── section-guide.md
-```
-
-## License
-
-MIT

package/.claude/skills/claude-md-generator/SKILL.md

@@ -1,248 +0,0 @@
----
-name: claude-md-generator
-description: Reads your codebase and writes a CLAUDE.md file that gives Claude Code the context it needs: build commands, test patterns, code style, architecture notes, and gotchas. Supports three modes: create (new file), update (improve existing), audit (score all CLAUDE.md files A-F and report quality). Keeps output under 100 lines. Use when asked to create or improve CLAUDE.md, audit Claude configuration, write AI coding context, or set up Claude for a new project. Trigger when a user says "create a CLAUDE.md", "generate CLAUDE.md", "audit my CLAUDE.md", "help Claude understand my project", or "set up Claude for this repo".
-compatibility: [claude-code, gemini-cli, github-copilot]
----
-
-# CLAUDE.md Generator
-
-Read the codebase. Write a CLAUDE.md that tells Claude exactly what it needs: no more, no less.
-
----
-
-**Critical rule:** A good CLAUDE.md is under 100 lines. It contains only information Claude cannot derive from reading the code itself. Do not auto-write the file: always show the draft and wait for user approval first.
-
-**Code snippet rule:** Never include inline code examples in CLAUDE.md. Instead use `file.ts:42` references. Code in CLAUDE.md wastes tokens and goes stale.
-
----
-
-## Step 1: Detect Mode
-
-Determine which of three modes to run:
-
-**create**: No CLAUDE.md exists. Write one from scratch.
-**update**: A CLAUDE.md exists. Improve it without discarding custom content.
-**audit**: Score all CLAUDE.md files in the project A-F and output a quality report. If the user says "audit", "check", "review", or "grade" my CLAUDE.md, run audit mode.
-
-```bash
-# Discover ALL CLAUDE.md locations
-find . -name "CLAUDE.md" -not -path "*/node_modules/*" -not -path "*/.git/*" 2>/dev/null
-ls ~/.claude/CLAUDE.md 2>/dev/null && echo "Global CLAUDE.md found"
-ls .claude.local.md 2>/dev/null && echo ".claude.local.md found"
-```
-
-If multiple CLAUDE.md files are found: list them. Ask: "Found CLAUDE.md in [locations]. Should I update all of them or just [root]?"
-
----
-
-## Step 2: Audit Mode (skip to Step 3 if create/update)
-
-For each CLAUDE.md found, score it A-F using this rubric:
-
-| Criterion | What to check |
-|-----------|--------------|
-| Commands | Build/test/lint commands present and runnable? |
-| Architecture | Non-obvious structure explained? |
-| Non-obvious patterns | Gotchas, generated files, env var order documented? |
-| Conciseness | Under 100 lines? No obvious filler? |
-| Currency | Commands still match current package.json/Makefile? |
-| Actionability | Can a new contributor follow this without asking questions? |
-
-Score: 90-100 = A, 70-89 = B, 50-69 = C, 30-49 = D, 0-29 = F
-
-Present as a table:
-
-```
-## CLAUDE.md Audit Report
-
-| File | Score | Grade | Top Issues |
-|------|-------|-------|-----------|
-| ./CLAUDE.md | 72 | B | Missing gotchas section, test command outdated |
-| ./packages/api/CLAUDE.md | 45 | D | No commands, 340 lines (too long), stale arch notes |
-
-**Overall: B (72/100)**
-
-Issues found:
-- ./packages/api/CLAUDE.md: 340 lines: well over the 100-line target
-- ./packages/api/CLAUDE.md: Test command references `jest` but package.json uses `vitest`
-- ./CLAUDE.md: No Gotchas section: most valuable section is missing
-```
-
-After the report, ask: "Want me to fix any of these? (all / just root / specify)"
-
-If user says yes, continue to Step 3 for each file they want fixed.
-
----
-
-## Step 3: Scan Project Structure
-
-```bash
-# Project type and package manager
-ls package.json yarn.lock pnpm-lock.yaml bun.lockb requirements.txt pyproject.toml Cargo.toml go.mod 2>/dev/null
-
-# Top-level directory structure
-find . -maxdepth 2 -type d \
-  | grep -v node_modules | grep -v .git | grep -v __pycache__ \
-  | grep -v ".next" | grep -v dist | grep -v build | sort
-```
-
----
-
-## Step 4: Extract Build and Test Commands
-
-```bash
-# npm/yarn/pnpm/bun scripts
-cat package.json 2>/dev/null \
-  | python3 -c "
-import sys, json
-d = json.load(sys.stdin)
-for name, cmd in d.get('scripts', {}).items():
-    print(f'{name}: {cmd}')
-"
-
-# Python, Go, Rust Makefiles
-cat Makefile 2>/dev/null | grep -E "^[a-z].*:" | head -20
-
-# Go
-cat go.mod 2>/dev/null | head -5
-
-# Rust
-cat Cargo.toml 2>/dev/null | grep -E "^\[" | head -10
-```
-
-Identify the exact commands for: build, test (all), test (single file/name), dev server, lint/typecheck. Note any env vars required to run them.
-
----
-
-## Step 5: Find Code Style and Gotchas
-
-```bash
-# Import aliases (most commonly missed)
-python3 -c "
-import json, sys
-try:
-    d = json.load(open('tsconfig.json'))
-    paths = d.get('compilerOptions', {}).get('paths', {})
-    if paths: print('Import aliases:', json.dumps(paths, indent=2))
-except: pass
-" 2>/dev/null
-
-# Environment variables required
-cat .env.example 2>/dev/null | grep -v "^#" | grep -v "^$" | head -20
-
-# Auto-generated files (must not be edited)
-find . -path "*/node_modules" -prune -o -name "*.ts" -print \
-  | xargs grep -l "DO NOT EDIT\|@generated\|Generated by" 2>/dev/null | head -5
-
-# Test setup requirements
-cat jest.config.js jest.config.ts vitest.config.ts 2>/dev/null | head -30
-
-# Database/migration setup
-ls migrations/ prisma/ drizzle/ db/ 2>/dev/null
-```
-
-**What counts as a Gotcha** (include these, skip everything else):
-- Files that are auto-generated (must not edit)
-- Env vars required BEFORE tests run
-- Non-default import alias mappings
-- Test commands that require a running service
-- Known intentional quirks (workarounds, not bugs)
-
----
-
-## Step 6: Generate CLAUDE.md Draft with Gemini
-
-Compile all findings and generate the draft:
-
-```bash
-cat > /tmp/claude-md-request.json << 'ENDJSON'
-{
-  "system_instruction": {
-    "parts": [{
-      "text": "Write a CLAUDE.md file for a software project. Rules: (1) Under 100 lines total. (2) Only include what Claude cannot derive from reading the code. (3) No inline code examples: use file.ts:42 references instead. (4) Sections: Commands, Code Style (only non-defaults), Testing (only if setup needed), Gotchas (required: what trips people up). Skip any section that has nothing non-obvious to say. (5) All commands in code blocks. (6) Preferred order: short Project Overview (1-2 sentences, only if non-obvious), Commands, Architecture (only non-obvious structure), Code Style, Testing, Gotchas. (7) Do not use em dashes. (8) Output only the CLAUDE.md content, no commentary."
-    }]
-  },
-  "contents": [{
-    "parts": [{
-      "text": "PROJECT_ANALYSIS_HERE"
-    }]
-  }],
-  "generationConfig": {
-    "temperature": 0.3,
-    "maxOutputTokens": 2048
-  }
-}
-ENDJSON
-
-curl -s -X POST \
-  "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d @/tmp/claude-md-request.json \
-  | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['candidates'][0]['content']['parts'][0]['text'])"
-```
-
-Replace `PROJECT_ANALYSIS_HERE` with findings from Steps 3-5.
-
-**For large projects (50+ files):** Add a `@path` pointer at the bottom of CLAUDE.md instead of inline detail:
-
-```markdown
-## Extended Reference
-See @docs/ai-context/architecture.md for full module map.
-See @docs/ai-context/testing.md for integration test setup details.
-```
-
-Write the referenced files to `docs/ai-context/` with the detail that would not fit in 100 lines.
-
----
-
-## Step 7: Self-QA
-
-Before presenting the draft, check:
-
-- [ ] Under 100 lines (count: `echo "$CONTENT" | wc -l`)
-- [ ] No inline code examples (only `file.ts:42` references or shell commands)
-- [ ] All commands in code blocks and runnable as-is
-- [ ] Gotchas section present with at least one real entry
-- [ ] No section that says only things obvious from the files
-- [ ] No em dashes
-- [ ] No marketing words or filler phrases ("This project uses React to...")
-- [ ] Import aliases documented if they exist
-- [ ] Auto-generated files marked "do not edit" if they exist
-
-If any check fails, revise before presenting.
-
----
-
-## Step 8: Present Draft and Wait for Approval
-
-**Never write the file without user approval.**
-
-Present the draft in a code block:
-
-```
-## Draft CLAUDE.md ([N] lines)
-
-[full draft content here]
-
----
-Write this to CLAUDE.md? (yes / edit first / cancel)
-```
-
-If user says **yes**: write the file, then confirm:
-"CLAUDE.md written ([N] lines). Sections: [list of ## headers]."
-
-If user says **edit first**: apply their edits, re-show the draft.
-
-If user says **cancel**: stop.
-
----
-
-## What NOT to Include
-
-- Language/framework version ("This is a TypeScript project")
-- How the framework works (Claude already knows React, FastAPI, etc.)
-- List of all dependencies
-- Style rules the linter already enforces (indent size, quote style)
-- Content that duplicates README.md
-- Inline code examples or multi-line snippets
-- Anything that would be identical for any project using the same stack

package/.claude/skills/claude-md-generator/evals/evals.json

@@ -1,35 +0,0 @@
-{
-  "skill_name": "claude-md-generator",
-  "evals": [
-    {
-      "id": 1,
-      "prompt": "Generate a CLAUDE.md for this project.",
-      "expected_output": "Agent runs all scan commands from Steps 1-5: directory structure, package.json scripts, tsconfig.json, ESLint config, test setup, .env.example. Calls Gemini with analysis to generate CLAUDE.md. Output is under 200 lines. Contains: Commands section with exact runnable commands, Code Style section noting any non-default aliases or export conventions, Testing section with any required setup, Gotchas section with at least one entry (auto-generated files, required env vars, etc.). Does not include obvious facts derivable from the files (e.g., 'This project uses TypeScript').",
-      "files": ["package.json", "tsconfig.json", ".eslintrc.json", ".env.example"]
-    },
-    {
-      "id": 2,
-      "prompt": "Create a CLAUDE.md. The project already has one.",
-      "expected_output": "Agent detects existing CLAUDE.md at project root. Reads it before generating. Preserves any sections the user has manually added. Improves sections that are outdated or missing. Shows a diff summary: 'Kept: [sections]. Updated: [sections]. Added: [sections].' Final file is still under 200 lines. Does not wholesale replace the existing file without showing what changed.",
-      "files": ["CLAUDE.md", "package.json"]
-    },
-    {
-      "id": 3,
-      "prompt": "Write a CLAUDE.md for this Python project.",
-      "expected_output": "Agent detects Python project from requirements.txt or pyproject.toml. Reads Makefile or pyproject.toml for commands. Identifies test runner (pytest, unittest). Notes any virtual environment setup required. Checks for generated files (migrations, protobuf stubs). Commands section shows exact Python commands (pytest, python -m, etc.). Gotchas section notes any required env vars and any generated files that should not be edited.",
-      "files": ["requirements.txt", "pyproject.toml", "Makefile"]
-    },
-    {
-      "id": 4,
-      "prompt": "Generate CLAUDE.md for this monorepo.",
-      "expected_output": "Agent detects monorepo from presence of packages/ or apps/ directory with multiple package.json files. Notes workspace structure in Architecture section. Documents root-level commands vs package-level commands. Notes any shared packages and how they are linked. Keeps the output under 200 lines by focusing on the most important commands and conventions. Does not try to document every package: focuses on the top-level patterns and the most commonly developed packages.",
-      "files": ["package.json", "packages/"]
-    },
-    {
-      "id": 5,
-      "prompt": "Create a CLAUDE.md. There are no config files: it's a small Go project with just main.go and a Makefile.",
-      "expected_output": "Agent finds main.go and Makefile. Reads Makefile for build/test/run targets. Notes that there is no package manager. Commands section shows make targets. Architecture section notes entry point (main.go). Gotchas section notes any env vars referenced in main.go. Output is short (under 50 lines) because there is not much to document: the agent does not pad with filler content. Does not invent sections for things that do not exist in this project.",
-      "files": ["main.go", "Makefile"]
-    }
-  ]
-}

package/.claude/skills/claude-md-generator/references/section-guide.md

@@ -1,175 +0,0 @@
-# CLAUDE.md Section Guide
-
-What to include in each section and what to leave out.
-
----
-
-## Canonical Section Order
-
-```markdown
-# CLAUDE.md
-
-## Project Overview
-## Commands
-## Architecture
-## Code Style
-## Testing
-## Gotchas
-```
-
-Not all sections are required. If a section has nothing non-obvious to say, omit it.
-
----
-
-## Project Overview
-
-**Include:**
-- What the project does in one sentence (only if it is not obvious from the directory name)
-- The core tech stack if it is unusual or non-standard for the file types present
-- Any important context for understanding the codebase (e.g., "this is the billing service, not the main app")
-
-**Do not include:**
-- "This is a Next.js project" (Claude can see the files)
-- Marketing copy about what the product does for users
-- History of the project or team
-
-**Example: good:**
-```markdown
-## Project Overview
-The billing service. Handles subscription lifecycle, invoices, and Stripe webhooks. Runs as a standalone Express app; the main app in /apps/web calls it via internal API.
-```
-
----
-
-## Commands
-
-**Include:**
-- The exact command to run the dev server
-- The exact command to run all tests
-- How to run a single test file or test by name
-- How to build for production
-- Lint/typecheck command
-- Any command that requires setup steps to work (note the setup)
-- Database migration commands if they are needed before running tests
-
-**Do not include:**
-- Commands that are self-explanatory from package.json (`npm install`, `npm start`)
-- Commands that Claude can infer from the framework
-
-**Example: good:**
-```markdown
-## Commands
-- Dev: `npm run dev` (starts on port 3000)
-- Test: `npm test` (requires `DATABASE_URL` in .env.local)
-- Test single file: `npm test -- --testPathPattern=auth`
-- Lint: `npm run lint`
-- Build: `npm run build && npm run export`
-- DB migrations: `npm run db:migrate` (run after pulling main)
-```
-
----
-
-## Architecture
-
-**Include:**
-- Non-obvious directory organization (e.g., why `lib/` vs `utils/` exists)
-- How the main entry points connect to each other
-- External services and what they are used for
-- Any generated directories that should not be edited
-
-**Do not include:**
-- "The src directory contains source code" (obvious)
-- Framework defaults ("pages directory is for Next.js pages")
-- Descriptions of standard patterns (REST API routes, MVC structure)
-
-**Example: good:**
-```markdown
-## Architecture
-`src/api/`: Express route handlers only. Business logic lives in `src/services/`.
-`src/generated/`: Auto-generated from Prisma schema and GraphQL introspection. Do not edit these files.
-The queue workers (`src/workers/`) are separate processes; they share the database but do not import from `src/api/`.
-```
-
----
-
-## Code Style
-
-**Include:**
-- Anything that differs from the linter/formatter default
-- Import alias mappings (`@/` = `src/`, `~components/` = `src/components/`)
-- Export convention (named vs default) if the project enforces one consistently
-- File naming convention if it differs from framework default
-- Any rule about where to put types
-
-**Do not include:**
-- Indent size and tab/space settings (the formatter enforces this)
-- "We use TypeScript" (obviously visible from the files)
-- ESLint rules that are already in .eslintrc
-
-**Example: good:**
-```markdown
-## Code Style
-- Imports: use `@/` alias for `src/` (configured in tsconfig paths and Jest moduleNameMapper)
-- Exports: named exports only: no default exports except for Next.js pages
-- Types: co-located with the code that uses them; shared types in `src/types/`
-- Components: one component per file, file name matches component name
-```
-
----
-
-## Testing
-
-**Include:**
-- How to run tests (if not already in Commands)
-- What needs to be running for tests to pass (database, mock server, env vars)
-- Test file naming convention if non-standard
-- Where fixtures or test data live
-- Any `beforeAll` setup that is important to know about
-
-**Do not include:**
-- "We use Jest" (visible from package.json)
-- "Tests go in the tests directory" (obvious from the file structure)
-
-**Example: good:**
-```markdown
-## Testing
-Tests require a running PostgreSQL instance. Start it with `docker compose up -d db` before running `npm test`.
-Test files: `*.test.ts` next to the source file. Integration tests: `tests/integration/*.test.ts`.
-Fixtures: `tests/fixtures/`: seeded before each test suite in `tests/setup.ts`.
-```
-
----
-
-## Gotchas
-
-**The most important section.** This is where you put the things that will waste 30+ minutes if not documented.
-
-**Always include:**
-- Things that look like they should work but do not
-- Files that are auto-generated and should not be edited manually
-- Env vars that must exist before the app starts
-- Dependencies between services (e.g., must start service A before service B)
-- Known issues that are intentional (not bugs)
-- Auth setup that differs from standard
-
-**Examples:**
-
-```markdown
-## Gotchas
-- `src/graphql/types.ts` is auto-generated by `npm run codegen`. Do not edit it directly.
-- The test database is separate from the dev database. Run `npm run db:seed:test` once before running tests for the first time.
-- `NEXT_PUBLIC_API_URL` must be set at build time (not runtime): changing it requires a rebuild.
-- The `useAuth` hook returns `null` during SSR. Guard with `if (!user)` before accessing user properties.
-- Tailwind classes are not purged during dev but are in production. If a class works in dev but disappears in production, check that it appears as a complete string (not assembled dynamically).
-```
-
----
-
-## What CLAUDE.md is NOT
-
-- Not a README for human developers
-- Not documentation of how the framework works
-- Not a list of all dependencies
-- Not a tutorial for new team members
-
-If a section would read the same for any project using the same framework, cut it.

package/src/e2e.test.ts

@@ -1,38 +0,0 @@
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { execSync } from 'node:child_process';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-
-describe('CLI End-to-End Tests', () => {
-  let tempDir: string;
-  let cliPath: string;
-
-  beforeAll(() => {
-    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'opendirectory-cli-test-'));
-    cliPath = path.resolve(__dirname, '../dist/index.js');
-    
-    if (!fs.existsSync(cliPath)) {
-      execSync('pnpm run build', { cwd: path.resolve(__dirname, '..') });
-    }
-  });
-
-  afterAll(() => {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  });
-
-  it('should install a skill for opencode locally', () => {
-    const skillName = 'claude-md-generator';
-    
-    // Set HOME and USERPROFILE to tempDir so that ~ resolves to tempDir
-    const env = { ...process.env, HOME: tempDir, USERPROFILE: tempDir };
-    
-    execSync(`node "${cliPath}" install ${skillName} --target opencode`, { cwd: tempDir, env });
-    
-    const expectedPath = path.join(tempDir, '.config', 'opencode', 'skills', skillName, 'SKILL.md');
-    expect(fs.existsSync(expectedPath)).toBe(true);
-    
-    const content = fs.readFileSync(expectedPath, 'utf-8');
-    expect(content.length).toBeGreaterThan(0);
-  });
-});

package/src/fs-adapters.test.ts

@@ -1,91 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import * as os from 'node:os';
-import { resolvePath, safeWriteFile, safeAppendFile } from './fs-adapters';
-
-describe('fs-adapters', () => {
-  let tempDir: string;
-
-  beforeEach(async () => {
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fs-adapters-test-'));
-  });
-
-  afterEach(async () => {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  });
-
-  describe('resolvePath', () => {
-    it('should resolve ~ to home directory', () => {
-      const home = os.homedir();
-      expect(resolvePath('~/foo/bar')).toBe(path.join(home, 'foo/bar'));
-      expect(resolvePath('~')).toBe(home);
-    });
-
-    it('should resolve absolute paths', () => {
-      const absPath = path.resolve('/foo/bar');
-      expect(resolvePath('/foo/bar')).toBe(absPath);
-    });
-
-    it('should resolve relative paths', () => {
-      const relPath = path.resolve('foo/bar');
-      expect(resolvePath('foo/bar')).toBe(relPath);
-    });
-  });
-
-  describe('safeWriteFile', () => {
-    it('should create directory and write file', async () => {
-      const filePath = path.join(tempDir, 'nested', 'dir', 'test.txt');
-      await safeWriteFile(filePath, 'hello world');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('hello world');
-    });
-
-    it('should overwrite existing file', async () => {
-      const filePath = path.join(tempDir, 'test.txt');
-      await safeWriteFile(filePath, 'hello world');
-      await safeWriteFile(filePath, 'new content');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('new content');
-    });
-  });
-
-  describe('safeAppendFile', () => {
-    it('should create file if it does not exist', async () => {
-      const filePath = path.join(tempDir, 'nested', 'test.txt');
-      await safeAppendFile(filePath, 'hello world');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('hello world');
-    });
-
-    it('should append to existing file', async () => {
-      const filePath = path.join(tempDir, 'test.txt');
-      await safeWriteFile(filePath, 'line 1\n');
-      await safeAppendFile(filePath, 'line 2');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('line 1\nline 2');
-    });
-
-    it('should add newline if existing file does not end with one', async () => {
-      const filePath = path.join(tempDir, 'test.txt');
-      await safeWriteFile(filePath, 'line 1');
-      await safeAppendFile(filePath, 'line 2');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('line 1\nline 2');
-    });
-
-    it('should not append if content already exists', async () => {
-      const filePath = path.join(tempDir, 'test.txt');
-      await safeWriteFile(filePath, 'existing content\nmore stuff');
-      await safeAppendFile(filePath, 'existing content');
-      
-      const content = await fs.readFile(filePath, 'utf-8');
-      expect(content).toBe('existing content\nmore stuff');
-    });
-  });
-});

package/src/fs-adapters.ts

@@ -1,65 +0,0 @@
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import * as os from 'node:os';
-
-export function resolvePath(p: string): string {
-  if (p.startsWith('~/') || p === '~') {
-    return path.resolve(p.replace(/^~/, os.homedir()));
-  }
-  return path.resolve(p);
-}
-
-export async function safeWriteFile(filePath: string, content: string): Promise<void> {
-  const resolvedPath = resolvePath(filePath);
-  const dir = path.dirname(resolvedPath);
-  await fs.mkdir(dir, { recursive: true });
-  await fs.writeFile(resolvedPath, content, 'utf-8');
-}
-
-export async function safeAppendFile(filePath: string, content: string): Promise<void> {
-  const resolvedPath = resolvePath(filePath);
-  const dir = path.dirname(resolvedPath);
-  await fs.mkdir(dir, { recursive: true });
-
-  try {
-    const existingContent = await fs.readFile(resolvedPath, 'utf-8');
-    if (existingContent.includes(content)) {
-      return;
-    }
-    
-    const prefix = existingContent.length > 0 && !existingContent.endsWith('\n') ? '\n' : '';
-    await fs.appendFile(resolvedPath, prefix + content, 'utf-8');
-  } catch (error: any) {
-    if (error.code === 'ENOENT') {
-      await fs.writeFile(resolvedPath, content, 'utf-8');
-    } else {
-      throw error;
-    }
-  }
-}
-
-export async function updateHermesConfig(): Promise<void> {
-  const configPath = resolvePath('~/.hermes/config.yaml');
-  
-  try {
-    let content = await fs.readFile(configPath, 'utf-8');
-    
-    if (!content.includes('skills:')) {
-      const prefix = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
-      content += prefix + 'skills:\n  external_dirs:\n    - "./.hermes/skills"\n';
-    } else if (!content.includes('external_dirs:')) {
-      content = content.replace(/(skills:\s*\n)/, '$1  external_dirs:\n    - "./.hermes/skills"\n');
-    } else if (!content.includes('./.hermes/skills')) {
-      content = content.replace(/(external_dirs:\s*\n)/, '$1    - "./.hermes/skills"\n');
-    }
-    
-    await fs.writeFile(configPath, content, 'utf-8');
-  } catch (error: any) {
-    if (error.code === 'ENOENT') {
-      const initialContent = `skills:\n  external_dirs:\n    - "./.hermes/skills"\n`;
-      await safeWriteFile('~/.hermes/config.yaml', initialContent);
-    } else {
-      throw error;
-    }
-  }
-}

package/src/index.ts

@@ -1,179 +0,0 @@
-#!/usr/bin/env node
-
-import { Command } from 'commander';
-import * as fs from 'node:fs/promises';
-import * as fsSync from 'node:fs';
-import * as path from 'node:path';
-import { Skill } from './transformers';
-import { safeWriteFile } from './fs-adapters';
-import chalk from 'chalk';
-import ora from 'ora';
-import Table from 'cli-table3';
-
-const program = new Command();
-
-const pkg = JSON.parse(fsSync.readFileSync(path.join(__dirname, '../package.json'), 'utf-8'));
-
-program
-  .name('@opendirectory.dev/skills')
-  .description(chalk.blue.bold('CLI to install OpenDirectory skills'))
-  .version(pkg.version);
-
-const getProjectRoot = () => {
-  return path.resolve(__dirname, '..');
-};
-
-program
-  .command('list')
-  .description('List available skills in the Open Directory registry')
-  .action(async () => {
-    const spinner = ora('Fetching available skills...').start();
-    try {
-      const root = getProjectRoot();
-      const registryPath = path.join(root, 'registry.json');
-      
-      let skills: any[] = [];
-      try {
-        const registryContent = await fs.readFile(registryPath, 'utf-8');
-        skills = JSON.parse(registryContent);
-      } catch (e) {
-        const skillsDir = path.join(root, 'skills');
-        const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-        skills = entries
-          .filter(entry => entry.isDirectory())
-          .map(entry => ({ name: entry.name, description: `Skill: ${entry.name}` }));
-      }
-
-      spinner.stop();
-      console.log(chalk.green('Successfully loaded Open Directory registry!\n'));
-
-      const table = new Table({
-        head: [chalk.cyan.bold('Skill Name'), chalk.cyan.bold('Description')],
-        colWidths: [35, 75],
-        wordWrap: true
-      });
-
-      for (const skill of skills) {
-        let desc = skill.description || '';
-        desc = desc.replace(/<img[^>]*>/g, '').trim();
-        if (desc.length > 100) desc = desc.substring(0, 97) + '...';
-        
-        table.push([chalk.yellow(skill.name), desc]);
-      }
-      
-      console.log(table.toString());
-      console.log(chalk.gray(`\nRun \`${chalk.white('npx "@opendirectory.dev/skills" install <skill-name> --target <agent>')}\` to install a skill.`));
-
-    } catch (error) {
-      spinner.stop();
-      console.error(chalk.red('Failed to list skills.'));
-      console.error(error);
-    }
-  });
-
-program
-  .command('install <skill>')
-  .description('Install a skill for your AI agent')
-  .requiredOption('-t, --target <tool>', 'Target agent (opencode, claude, codex, gemini, anti-gravity, openclaw, hermes)')
-  .action(async (skillName, options) => {
-    const spinner = ora(`Installing ${chalk.yellow(skillName)}...`).start();
-    try {
-      const root = getProjectRoot();
-      const repoDir = path.join(root, 'skills', skillName);
-      
-      let skillDir = repoDir;
-      let skillMdPath = path.join(skillDir, 'SKILL.md');
-      
-      try {
-        await fs.access(skillMdPath);
-      } catch (e) {
-        try {
-          const entries = await fs.readdir(repoDir, { withFileTypes: true });
-          for (const entry of entries) {
-            if (entry.isDirectory()) {
-              const possiblePath = path.join(repoDir, entry.name, 'SKILL.md');
-              try {
-                await fs.access(possiblePath);
-                skillDir = path.join(repoDir, entry.name);
-                skillMdPath = possiblePath;
-                break;
-              } catch (err) {}
-            }
-          }
-          if (skillDir === repoDir) {
-            for (const entry of entries) {
-              if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== '.git') {
-                const subDir = path.join(repoDir, entry.name);
-                const subEntries = await fs.readdir(subDir, { withFileTypes: true });
-                for (const subEntry of subEntries) {
-                  if (subEntry.isDirectory()) {
-                    const possiblePath = path.join(subDir, subEntry.name, 'SKILL.md');
-                    try {
-                      await fs.access(possiblePath);
-                      skillDir = path.join(subDir, subEntry.name);
-                      skillMdPath = possiblePath;
-                      break;
-                    } catch (err) {}
-                  }
-                }
-              }
-            }
-          }
-        } catch (dirErr) {
-          spinner.stop();
-          console.error(chalk.red(`Error: Repository '${skillName}' not found.`));
-          console.log(chalk.gray(`Try running \`${chalk.white('npx "@opendirectory.dev/skills" list')}\` to see available skills.`));
-          process.exit(1);
-        }
-      }
-
-      try {
-        await fs.access(skillMdPath);
-      } catch (e) {
-        spinner.stop();
-        console.error(chalk.red(`Error: Skill '${skillName}' missing SKILL.md in registry.`));
-        process.exit(1);
-      }
-      
-      const actualSkillFolderName = path.basename(skillDir);
-      const finalSkillName = actualSkillFolderName === skillName ? skillName : actualSkillFolderName;
-
-      const target = options.target.toLowerCase();
-
-      const validTargets = ['opencode', 'claude', 'codex', 'gemini', 'anti-gravity', 'openclaw', 'hermes'];
-
-      if (validTargets.includes(target)) {
-        let targetFolder = '';
-        if (target === 'opencode') targetFolder = `~/.config/opencode/skills/${finalSkillName}`;
-        if (target === 'claude') targetFolder = `~/.claude/skills/${finalSkillName}`;
-        if (target === 'codex') targetFolder = `~/.codex/skills/${finalSkillName}`;
-        if (target === 'gemini') targetFolder = `~/.gemini/skills/${finalSkillName}`;
-        if (target === 'anti-gravity') targetFolder = `~/.gemini/antigravity/skills/${finalSkillName}`;
-        if (target === 'openclaw') targetFolder = `~/.openclaw/skills/${finalSkillName}`;
-        if (target === 'hermes') targetFolder = `~/.hermes/skills/${finalSkillName}`;
-        
-        const { resolvePath } = require('./fs-adapters');
-        const resolvedDest = resolvePath(targetFolder);
-        await fs.mkdir(resolvedDest, { recursive: true });
-        await fs.cp(skillDir, resolvedDest, { recursive: true });
-        
-        spinner.stop();
-        console.log(chalk.green(`Successfully installed ${chalk.bold(finalSkillName)}!`));
-        console.log(`\n  ${chalk.cyan('Agent:')}   ${target}`);
-        console.log(`  ${chalk.cyan('Scope:')}   Global`);
-        console.log(`  ${chalk.cyan('Path:')}    ${targetFolder}\n`);
-      } else {
-        spinner.stop();
-        console.error(chalk.red(`Error: Unsupported target '${target}'.`));
-        console.log(chalk.gray(`Supported targets: ${validTargets.join(', ')}`));
-        process.exit(1);
-      }
-    } catch (error) {
-      spinner.stop();
-      console.error(chalk.red('Failed to install skill.'));
-      console.error(error);
-      process.exit(1);
-    }
-  });
-
-program.parse();

package/src/transformers.ts

@@ -1,6 +0,0 @@
-export interface Skill {
-  name: string;
-  description: string;
-  content: string;
-  globs?: string;
-}

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "rootDir": "src",
-    "outDir": "dist"
-  },
-  "include": ["src/**/*"]
-}