prd-to-skill 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# prd-to-skill
+
+Convert PRD documents (PDF/DOCX) into AI coding assistant instruction files.
+
+Supports **Claude Code**, **Cursor**, **OpenAI Codex**, **GitHub Copilot**, **Windsurf**, and **Aider** — each with the correct file format and output location.
+
+## Quick Start
+
+```bash
+# Set your API key
+export OPENAI_API_KEY="sk-..."
+
+# Generate a Claude Code skill (default)
+npx prd-to-skill ./my-feature-prd.pdf
+
+# Generate a Cursor rule
+npx prd-to-skill ./my-feature-prd.pdf --target cursor
+
+# Generate for all tools at once
+for t in claude cursor codex copilot windsurf aider; do
+  npx prd-to-skill ./my-feature-prd.pdf --target $t
+done
+```
+
+## Supported Targets
+
+| Target         | Flag                        | Output Path                                   | Format                      |
+| -------------- | --------------------------- | --------------------------------------------- | --------------------------- |
+| Claude Code    | `--target claude` (default) | `.claude/commands/<name>.md`                  | Markdown + YAML frontmatter |
+| Cursor         | `--target cursor`           | `.cursor/rules/<name>.mdc`                    | MDC + YAML frontmatter      |
+| OpenAI Codex   | `--target codex`            | `./AGENTS.md`                                 | Plain Markdown              |
+| GitHub Copilot | `--target copilot`          | `.github/instructions/<name>.instructions.md` | Markdown + YAML frontmatter |
+| Windsurf       | `--target windsurf`         | `.windsurf/rules/<name>.md`                   | Plain Markdown              |
+| Aider          | `--target aider`            | `./CONVENTIONS.md`                            | Plain Markdown              |
+
+Output directories are created automatically if they don't exist.
+
+## Supported LLM Providers
+
+The tool auto-detects your provider from environment variables (checked in this order):
+
+| Provider  | Env Var             | Default Model              |
+| --------- | ------------------- | -------------------------- |
+| Anthropic | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514` |
+| OpenAI    | `OPENAI_API_KEY`    | `gpt-4o`                   |
+| Google    | `GOOGLE_API_KEY`    | `gemini-2.0-flash`         |
+| Mistral   | `MISTRAL_API_KEY`   | `mistral-large-latest`     |
+
+## Usage
+
+```bash
+prd-to-skill <file> [options]
+```
+
+### Options
+
+| Flag                       | Description                                                              | Default               |
+| -------------------------- | ------------------------------------------------------------------------ | --------------------- |
+| `-t, --target <target>`    | Target tool: `claude`, `cursor`, `codex`, `copilot`, `windsurf`, `aider` | `claude`              |
+| `-p, --provider <name>`    | LLM provider: `openai`, `anthropic`, `google`, `mistral`                 | Auto-detected         |
+| `-m, --model <model>`      | Model name                                                               | Provider default      |
+| `-o, --output <path>`      | Output file path (overrides default)                                     | Target-specific       |
+| `-n, --name <name>`        | Skill/rule name                                                          | Derived from filename |
+| `-d, --description <text>` | Description for frontmatter                                              | Generated by LLM      |
+| `--max-tokens <number>`    | Max output tokens                                                        | `4096`                |
+| `-v, --verbose`            | Show extraction and API details                                          |                       |
+
+### Examples
+
+```bash
+# Use a specific provider and model
+prd-to-skill ./prd.pdf --provider anthropic --model claude-sonnet-4-20250514
+
+# Generate a Cursor rule with custom name
+prd-to-skill ./prd.docx --target cursor --name auth-feature
+
+# Custom output path
+prd-to-skill ./prd.pdf --output ./my-custom-path/skill.md
+
+# Verbose mode
+prd-to-skill ./prd.pdf -v
+```
+
+## How It Works
+
+1. **Extracts text** from your PDF or Word document
+2. **Filters** for implementation-relevant content (requirements, architecture, business rules, acceptance criteria) and discards project management artifacts (timelines, stakeholders, budgets)
+3. **Sends to an LLM** with a target-specific prompt that generates the correct file format
+4. **Writes the file** to the right location for your chosen tool
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,538 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/extract.ts
+import { access } from "fs/promises";
+import { extname, resolve } from "path";
+var extractText = async (filePath) => {
+  const resolved = resolve(filePath);
+  try {
+    await access(resolved);
+  } catch {
+    throw new Error(`File not found: ${filePath}`);
+  }
+  const ext = extname(resolved).toLowerCase();
+  let text;
+  if (ext === ".pdf") {
+    const { PDFParse } = await import("pdf-parse");
+    const pdf = new PDFParse({ url: resolved });
+    const result = await pdf.getText();
+    text = result.text;
+  } else if (ext === ".docx" || ext === ".doc") {
+    const mammoth = await import("mammoth");
+    const result = await mammoth.extractRawText({ path: resolved });
+    text = result.value;
+  } else {
+    throw new Error(`Unsupported file type "${ext}". Supported: .pdf, .docx`);
+  }
+  text = text.trim().replace(/\n{3,}/g, "\n\n");
+  if (!text) {
+    throw new Error(
+      "No text could be extracted from the document. Is it a scanned PDF? (Scanned PDFs are not supported.)"
+    );
+  }
+  return text;
+};
+
+// src/prompt.ts
+var BASE_SYSTEM_PROMPT = `You are a technical writer specializing in AI coding assistant instruction files. You will receive the text content of a Product Requirements Document (PRD). Your job is to convert it into an instruction file for an AI coding tool.
+
+## What to Extract from the PRD
+
+Focus ONLY on implementation-relevant content:
+- Functional requirements \u2014 what the feature must do, user flows, expected behaviors
+- Technical constraints \u2014 stack choices, API contracts, data models, auth patterns, performance targets
+- Architecture decisions \u2014 component structure, naming conventions, integration points
+- Business rules \u2014 domain logic that affects code behavior
+- Acceptance criteria \u2014 what "done" looks like, edge cases to handle
+- UI/UX specs \u2014 layout structure, interaction patterns, responsive behavior
+
+## What to Discard
+
+Remove all non-technical content:
+- Timelines, milestones, sprint planning
+- Team assignments, RACI matrices
+- Stakeholder lists, approval workflows
+- Marketing copy, executive summaries
+- Budget, resource allocation
+- Meeting notes, decision logs
+
+## Content Guidelines
+
+Convert the PRD requirements into ACTIONABLE INSTRUCTIONS for an AI agent. Do NOT simply restate the PRD \u2014 transform it:
+
+1. **Overview section**: 1-3 sentences stating what this helps build and the core approach.
+
+2. **Structured sections**: Break the PRD's requirements into logical sections. Each section should contain:
+   - Clear headings (## level)
+   - Imperative instructions ("Create X", "Ensure Y", "When Z, do W")
+   - Concrete patterns, code examples, or file structures where relevant
+   - Decision criteria (if X, then Y; if Z, then W)
+
+3. **Technical specifications**: Convert vague PRD language into specific technical guidance. If the PRD says "should be fast", translate to specific patterns (lazy loading, pagination, caching strategies).
+
+4. **Architecture guidance**: Include file structure recommendations, naming conventions, and integration patterns.
+
+5. **Quality checklist**: End with a verification section listing what "done" looks like.
+
+## Style Rules
+
+- Write in direct, imperative voice ("Create the component", not "You should create the component")
+- Be specific and concrete \u2014 no hand-waving
+- Include code snippets for patterns that would be ambiguous in prose
+- Use tables for decision matrices or option comparisons
+- Address the reader as an AI agent that will execute these instructions
+- Every sentence should add actionable information
+- Remove filler, marketing language, and non-technical content
+
+Output ONLY the complete file. No preamble, no explanation, no code fences wrapping the entire output.`;
+var buildMessages = (prdText, name, target, description) => {
+  const systemPrompt = `${BASE_SYSTEM_PROMPT}
+
+## Output Format (${target.name})
+
+You are generating a file for: ${target.description}
+
+${target.formatInstructions}`;
+  let userContent = `Here is the PRD content to convert into an AI coding instruction file:
+
+<prd>
+${prdText}
+</prd>
+
+Name: ${name}`;
+  if (description) {
+    userContent += `
+Description: ${description}`;
+  }
+  return [
+    { role: "system", content: systemPrompt },
+    { role: "user", content: userContent }
+  ];
+};
+
+// src/providers/openai.ts
+var complete = async (config, messages) => {
+  const res = await fetch("https://api.openai.com/v1/chat/completions", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.apiKey}`
+    },
+    body: JSON.stringify({
+      model: config.model,
+      max_tokens: config.maxTokens,
+      messages: messages.map((m) => ({ role: m.role, content: m.content }))
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`OpenAI API error (${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  return data.choices[0].message.content;
+};
+
+// src/providers/anthropic.ts
+var complete2 = async (config, messages) => {
+  const systemMsg = messages.find((m) => m.role === "system");
+  const nonSystemMsgs = messages.filter((m) => m.role !== "system");
+  const res = await fetch("https://api.anthropic.com/v1/messages", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.apiKey,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify({
+      model: config.model,
+      max_tokens: config.maxTokens,
+      system: systemMsg?.content ?? "",
+      messages: nonSystemMsgs.map((m) => ({ role: m.role, content: m.content }))
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Anthropic API error (${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  return data.content[0].text;
+};
+
+// src/providers/google.ts
+var complete3 = async (config, messages) => {
+  const systemMsg = messages.find((m) => m.role === "system");
+  const nonSystemMsgs = messages.filter((m) => m.role !== "system");
+  const url = `https://generativelanguage.googleapis.com/v1beta/models/${config.model}:generateContent?key=${config.apiKey}`;
+  const contents = nonSystemMsgs.map((m) => ({
+    role: m.role === "assistant" ? "model" : "user",
+    parts: [{ text: m.content }]
+  }));
+  const body = {
+    contents,
+    generationConfig: {
+      maxOutputTokens: config.maxTokens
+    }
+  };
+  if (systemMsg) {
+    body.systemInstruction = { parts: [{ text: systemMsg.content }] };
+  }
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const respBody = await res.text();
+    throw new Error(`Google API error (${res.status}): ${respBody}`);
+  }
+  const data = await res.json();
+  return data.candidates[0].content.parts[0].text;
+};
+
+// src/providers/mistral.ts
+var complete4 = async (config, messages) => {
+  const res = await fetch("https://api.mistral.ai/v1/chat/completions", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${config.apiKey}`
+    },
+    body: JSON.stringify({
+      model: config.model,
+      max_tokens: config.maxTokens,
+      messages: messages.map((m) => ({ role: m.role, content: m.content }))
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`Mistral API error (${res.status}): ${body}`);
+  }
+  const data = await res.json();
+  return data.choices[0].message.content;
+};
+
+// src/providers/detect.ts
+var providers = [
+  {
+    name: "anthropic",
+    envVar: "ANTHROPIC_API_KEY",
+    defaultModel: "claude-sonnet-4-20250514",
+    complete: complete2
+  },
+  {
+    name: "openai",
+    envVar: "OPENAI_API_KEY",
+    defaultModel: "gpt-4o",
+    complete
+  },
+  {
+    name: "google",
+    envVar: "GOOGLE_API_KEY",
+    defaultModel: "gemini-2.0-flash",
+    complete: complete3
+  },
+  {
+    name: "mistral",
+    envVar: "MISTRAL_API_KEY",
+    defaultModel: "mistral-large-latest",
+    complete: complete4
+  }
+];
+var detectProvider = (explicit) => {
+  if (explicit) {
+    const provider = providers.find((p) => p.name === explicit);
+    if (!provider) {
+      throw new Error(
+        `Unknown provider "${explicit}". Supported: ${providers.map((p) => p.name).join(", ")}`
+      );
+    }
+    if (!process.env[provider.envVar]) {
+      throw new Error(`Provider "${explicit}" requires ${provider.envVar} to be set.`);
+    }
+    return provider;
+  }
+  for (const provider of providers) {
+    if (process.env[provider.envVar]) {
+      return provider;
+    }
+  }
+  throw new Error(
+    `No API key found. Set one of: ${providers.map((p) => p.envVar).join(", ")}`
+  );
+};
+var getApiKey = (provider) => {
+  const key = process.env[provider.envVar];
+  if (!key) {
+    throw new Error(`${provider.envVar} is not set.`);
+  }
+  return key;
+};
+
+// src/output.ts
+import { mkdir, writeFile } from "fs/promises";
+import { basename, dirname, join as join2, resolve as resolve2 } from "path";
+
+// src/targets.ts
+import { join } from "path";
+var targets = {
+  claude: {
+    name: "claude",
+    description: "Claude Code skill (.md with YAML frontmatter)",
+    extension: ".md",
+    outputDir: (cwd) => join(cwd, ".claude", "commands"),
+    formatInstructions: `The file MUST begin with YAML frontmatter:
+
+---
+name: <kebab-case-name>
+description: <1-2 sentence description of when to use this skill. Start with "Use when..." This description is used for automatic skill matching.>
+---
+
+Then the markdown body with ## sections.`
+  },
+  cursor: {
+    name: "cursor",
+    description: "Cursor rule (.mdc with YAML frontmatter)",
+    extension: ".mdc",
+    outputDir: (cwd) => join(cwd, ".cursor", "rules"),
+    formatInstructions: `The file MUST begin with YAML frontmatter:
+
+---
+description: <1-2 sentence description of when this rule applies>
+globs:
+alwaysApply: true
+---
+
+Then the markdown body with ## sections. Do NOT include a "name" field in frontmatter \u2014 Cursor uses the filename as the name.`
+  },
+  codex: {
+    name: "codex",
+    description: "OpenAI Codex CLI (AGENTS.md, plain markdown)",
+    extension: ".md",
+    outputDir: (cwd) => cwd,
+    formatInstructions: `The file is plain markdown with NO YAML frontmatter. Start directly with a heading:
+
+# <Title>
+
+Use standard markdown with ## sections. This file will be read as AGENTS.md by the Codex CLI. Keep it under 32 KiB.`
+  },
+  copilot: {
+    name: "copilot",
+    description: "GitHub Copilot instructions (.md in .github/)",
+    extension: ".instructions.md",
+    outputDir: (cwd) => join(cwd, ".github", "instructions"),
+    formatInstructions: `The file MUST begin with YAML frontmatter:
+
+---
+description: <1-2 sentence description of what this instruction covers>
+applyTo: "**"
+---
+
+Then the markdown body with ## sections. Write instructions as guidance for a coding assistant.`
+  },
+  windsurf: {
+    name: "windsurf",
+    description: "Windsurf rule (.md in .windsurf/rules/)",
+    extension: ".md",
+    outputDir: (cwd) => join(cwd, ".windsurf", "rules"),
+    formatInstructions: `The file is plain markdown with NO YAML frontmatter. Start directly with a heading:
+
+# <Title>
+
+Use structured markdown with ## sections, bullet points, and numbered lists for clear rules.`
+  },
+  aider: {
+    name: "aider",
+    description: "Aider conventions (CONVENTIONS.md, plain markdown)",
+    extension: ".md",
+    outputDir: (cwd) => cwd,
+    formatInstructions: `The file is plain markdown with NO YAML frontmatter. Start directly with a heading:
+
+# <Title>
+
+Use structured markdown with ## sections. Focus on coding guidelines, style preferences, patterns, and conventions that an AI coding assistant should follow.`
+  }
+};
+var TARGET_NAMES = Object.keys(targets);
+var getTarget = (name) => {
+  const target = targets[name];
+  if (!target) {
+    throw new Error(`Unknown target "${name}". Supported: ${TARGET_NAMES.join(", ")}`);
+  }
+  return target;
+};
+var getDefaultFilename = (target, name) => {
+  if (target.name === "codex") return "AGENTS.md";
+  if (target.name === "aider") return "CONVENTIONS.md";
+  return `${name}${target.extension}`;
+};
+
+// src/output.ts
+var deriveSkillName = (filePath) => basename(filePath).replace(/\.[^.]+$/, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+var deriveOutputPath = (name, target, outputFlag) => {
+  if (outputFlag) return resolve2(outputFlag);
+  const dir = target.outputDir(process.cwd());
+  const filename = getDefaultFilename(target, name);
+  return join2(dir, filename);
+};
+var writeSkillFile = async (content, outputPath) => {
+  const normalized = content.replace(/\r\n/g, "\n").trim() + "\n";
+  await mkdir(dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, normalized, "utf-8");
+};
+
+// src/generate.ts
+var generate = async (options) => {
+  const provider = detectProvider(options.provider);
+  const apiKey = getApiKey(provider);
+  const model = options.model ?? provider.defaultModel;
+  const name = options.name ?? deriveSkillName(options.filePath);
+  const target = getTarget(options.target);
+  const outputPath = deriveOutputPath(name, target, options.output);
+  if (options.verbose) {
+    console.error(`Provider: ${provider.name}`);
+    console.error(`Model: ${model}`);
+    console.error(`Target: ${target.name} (${target.description})`);
+    console.error(`Extracting text from: ${options.filePath}`);
+  }
+  const prdText = await extractText(options.filePath);
+  if (options.verbose) {
+    console.error(`Extracted ${prdText.length} characters`);
+  }
+  const messages = buildMessages(prdText, name, target, options.description);
+  if (options.verbose) {
+    console.error("Sending to LLM...");
+  }
+  const result = await provider.complete(
+    { apiKey, model, maxTokens: options.maxTokens },
+    messages
+  );
+  await writeSkillFile(result, outputPath);
+  console.log(`${target.name} file written to: ${outputPath}`);
+};
+
+// src/help.ts
+var providers2 = {
+  openai: {
+    name: "OpenAI",
+    envVar: "OPENAI_API_KEY",
+    docsUrl: "https://platform.openai.com/api-keys",
+    steps: `1. Sign up or log in at platform.openai.com
+2. Go to API Keys and create a new secret key
+3. Export it:  export OPENAI_API_KEY="sk-..."`
+  },
+  anthropic: {
+    name: "Anthropic",
+    envVar: "ANTHROPIC_API_KEY",
+    docsUrl: "https://console.anthropic.com/settings/keys",
+    steps: `1. Sign up or log in at console.anthropic.com
+2. Go to Settings > API Keys and create a key
+3. Export it:  export ANTHROPIC_API_KEY="sk-ant-..."`
+  },
+  google: {
+    name: "Google (Gemini)",
+    envVar: "GOOGLE_API_KEY",
+    docsUrl: "https://aistudio.google.com/apikey",
+    steps: `1. Go to Google AI Studio
+2. Click "Get API key" and create one
+3. Export it:  export GOOGLE_API_KEY="AI..."`
+  },
+  mistral: {
+    name: "Mistral",
+    envVar: "MISTRAL_API_KEY",
+    docsUrl: "https://console.mistral.ai/api-keys",
+    steps: `1. Sign up or log in at console.mistral.ai
+2. Go to API Keys and create a new key
+3. Export it:  export MISTRAL_API_KEY="..."`
+  }
+};
+var GENERAL_HELP = `
+prd-to-skill \u2014 Convert PRD documents into AI coding assistant instruction files.
+
+Takes a PDF or Word (.docx) PRD and generates a ready-to-use instruction file
+for your AI coding tool of choice.
+
+QUICK START:
+  export OPENAI_API_KEY="sk-..."
+  npx prd-to-skill ./my-prd.pdf
+
+SUPPORTED TARGETS:
+  claude     Claude Code skill        \u2192 .claude/commands/<name>.md
+  cursor     Cursor rule              \u2192 .cursor/rules/<name>.mdc
+  codex      OpenAI Codex CLI         \u2192 ./AGENTS.md
+  copilot    GitHub Copilot           \u2192 .github/instructions/<name>.instructions.md
+  windsurf   Windsurf rule            \u2192 .windsurf/rules/<name>.md
+  aider      Aider conventions        \u2192 ./CONVENTIONS.md
+
+SUPPORTED PROVIDERS:
+  openai     OPENAI_API_KEY           Default: gpt-4o
+  anthropic  ANTHROPIC_API_KEY        Default: claude-sonnet-4-20250514
+  google     GOOGLE_API_KEY           Default: gemini-2.0-flash
+  mistral    MISTRAL_API_KEY          Default: mistral-large-latest
+
+The provider is auto-detected from whichever API key you have set.
+For provider-specific setup, run:  prd-to-skill help <provider>
+
+EXAMPLES:
+  prd-to-skill ./prd.pdf
+  prd-to-skill ./prd.docx --target cursor
+  prd-to-skill ./prd.pdf --provider anthropic --model claude-sonnet-4-20250514
+  prd-to-skill ./prd.pdf -n auth-feature -o .claude/commands/auth.md
+`;
+var printHelp = (provider) => {
+  if (!provider) {
+    console.log(GENERAL_HELP.trim());
+    return;
+  }
+  const p = providers2[provider.toLowerCase()];
+  if (!p) {
+    console.error(
+      `Unknown provider "${provider}". Available: ${Object.keys(providers2).join(", ")}`
+    );
+    process.exit(1);
+  }
+  console.log(
+    `
+${p.name} Setup
+${"=".repeat(p.name.length + 6)}
+
+Env var:  ${p.envVar}
+Docs:     ${p.docsUrl}
+
+${p.steps}
+
+Then run:
+  prd-to-skill ./my-prd.pdf --provider ${provider.toLowerCase()}
+`.trim()
+  );
+};
+
+// src/index.ts
+var program = new Command();
+program.name("prd-to-skill").description(
+  "Convert PRD documents (PDF/DOCX) into AI coding assistant instruction files"
+).version("0.1.0");
+program.command("help [provider]").aliases(["h"]).description("Show detailed help, or setup guide for a specific provider").action((provider) => {
+  printHelp(provider);
+});
+program.argument("<file>", "Path to PRD file (.pdf or .docx)").option("-p, --provider <name>", "LLM provider: openai | anthropic | google | mistral").option("-m, --model <model>", "Model name (e.g. gpt-4o, claude-sonnet-4-20250514)").option("-o, --output <path>", "Output file path (overrides default)").option("-n, --name <name>", "Skill/rule name (default: derived from filename)").option("-d, --description <text>", "Description for frontmatter").option(`-t, --target <target>`, `Target tool: ${TARGET_NAMES.join(", ")}`, "claude").option("--max-tokens <number>", "Max output tokens", "4096").option("-v, --verbose", "Show extraction and API details").action(async (file, opts) => {
+  try {
+    await generate({
+      filePath: file,
+      provider: opts.provider,
+      model: opts.model,
+      name: opts.name,
+      description: opts.description,
+      output: opts.output,
+      target: opts.target,
+      maxTokens: parseInt(opts.maxTokens, 10),
+      verbose: opts.verbose ?? false
+    });
+  } catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "prd-to-skill",
+  "version": "0.1.1",
+  "description": "Convert PRD documents (PDF/DOCX) into AI coding assistant instruction files",
+  "type": "module",
+  "bin": {
+    "prd-to-skill": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean --shims --tsconfig tsconfig.build.json",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "prd",
+    "skill",
+    "claude",
+    "claude-code",
+    "cursor",
+    "codex",
+    "copilot",
+    "windsurf",
+    "aider",
+    "markdown",
+    "cli",
+    "ai"
+  ],
+  "lint-staged": {
+    "*.{ts,js}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leosantos/prd-to-skill"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "mammoth": "^1.12.0",
+    "pdf-parse": "^2.4.5"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.8.2",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.2",
+    "vitest": "^4.1.4"
+  }
+}