promptopskit 0.2.0 → 0.2.2

package/README.md

@@ -15,7 +15,7 @@ Provider adapters for OpenAI, Anthropic, Gemini, and OpenRouter produce a ready-
 - **Centralized, not scattered** — each prompt is a single Markdown file that captures prompt text, model config, tool bindings, and context rules together.
 - **Operational, not just templated** — model name, temperature, reasoning effort, tools, and response format are declared alongside the prompt they govern.
 - **Reusable, not duplicated** — `includes` lets you define shared tone, policy, or safety instructions once and compose them into any prompt.
-- **Layered defaults, not repetition** — `defaults.md` in any folder sets shared `metadata` and `# System instructions` for that subtree, with nearest-folder override behavior.
+- **Layered defaults, not repetition** — `defaults.md` in any folder sets shared `provider`, `model`, `metadata`, and `# System instructions` for that subtree, with nearest-folder override behavior.
 - **Release-aware, not ad hoc** — environment and tier overrides swap models and parameters without forking prompt files.
 - **Provider-portable** — write once, render for OpenAI, Anthropic, Gemini, or OpenRouter with correct body shapes.
 - **Validate early** — Zod schema validation, Levenshtein-based "did you mean?" suggestions for typos, and variable usage checks catch mistakes before runtime.
@@ -40,6 +40,7 @@ This creates:
 
 ```
 prompts/
+├── defaults.md         # Folder-level defaults (provider, model, metadata, system instructions)
 ├── hello.md            # Sample prompt with variables
 ├── hello.test.yaml     # Test sidecar with sample inputs
 └── shared/
@@ -50,7 +51,7 @@ prompts/
 
 ```markdown
 ---
-id: support.reply
+id: support/reply
 schema_version: 1
 provider: openai
 model: gpt-5.4
@@ -107,7 +108,7 @@ const response = await fetch('https://api.openai.com/v1/chat/completions', {
 - **Prompts as Markdown** — YAML front matter for settings, H1 headings for sections (`# System instructions`, `# Prompt template`, `# Notes`)
 - **Variable interpolation** — `{{ variable }}` syntax with strict and permissive modes
 - **Composition** — `includes` to share system instructions across prompts, with circular detection
-- **Folder defaults** — `defaults.md` inheritance for shared metadata and system instructions
+- **Folder defaults** — `defaults.md` inheritance for shared provider, model, metadata, and system instructions
 - **Overrides** — Environment and tier-based overrides (base → env → tier → runtime)
 - **4 provider adapters** — OpenAI, Anthropic, Gemini, OpenRouter — body-only output
 - **Validation** — Zod schema validation, Levenshtein-based "did you mean?" for typos, variable usage checks
@@ -169,15 +170,19 @@ Define environment and tier overrides in front matter. Precedence: **base → en
 
 ```markdown
 ---
-id: support.reply
+id: support/reply
 schema_version: 1
 provider: openai
 model: gpt-5.4
+reasoning:
+  effort: high
 sampling:
   temperature: 0.7
 environments:
   dev:
     model: gpt-5.4-mini
+    reasoning:
+      effort: low
     sampling:
       temperature: 0.2
   prod:
@@ -206,7 +211,7 @@ Share system instructions across prompts using `includes`. Included system instr
 
 ```markdown
 ---
-id: support.reply
+id: support/reply
 schema_version: 1
 includes:
   - ./shared/tone.md
@@ -221,6 +226,7 @@ Handle support requests carefully.
 
 Define a `defaults.md` file in `prompts/` (and optional subfolders) to provide inherited defaults for prompts:
 
+- Shared `provider` and `model` in front matter
 - Shared `metadata` defaults in front matter
 - Shared `# System instructions` in body
 - Nearest subfolder `defaults.md` overrides parent defaults
@@ -255,32 +261,30 @@ promptopskit render <file> [--env <name>] [--tier <name>] [--vars <file>] [--jso
 # Print normalized asset as JSON
 promptopskit inspect <file>
 
-# Deploy AI agent instructions into your project
-promptopskit skill [--target copilot|cursor|generic] [--force]
+# Deploy AI agent instructions for all major coding assistants
+promptopskit skill [--target agents|claude|copilot|cursor] [--force]
 ```
 
 ## AI Agent Instructions
 
-The `skill` command deploys a comprehensive instructions file so AI coding assistants (GitHub Copilot, Cursor, etc.) automatically understand how to create and manage prompts with promptopskit.
+The `skill` command deploys instruction files so AI coding assistants automatically understand how to create and manage prompts with promptopskit. By default it generates files for **all** major vendors:
 
 ```bash
-# Deploy for GitHub Copilot (default)
+# Deploy for all AI coding assistants (default)
 promptopskit skill
-# → .github/instructions/promptopskit.instructions.md
-
-# Deploy for Cursor
-promptopskit skill --target cursor
-# → .cursor/rules/promptopskit.mdc
+# → AGENTS.md                                          (Codex, OpenCode, Cursor, Copilot)
+# → CLAUDE.md                                          (Claude Code — imports AGENTS.md)
+# → .github/instructions/promptopskit.instructions.md  (GitHub Copilot)
+# → .cursor/rules/promptopskit.mdc                     (Cursor)
 
-# Deploy a generic instructions file
-promptopskit skill --target generic
-# → .ai/promptopskit-skill.md
+# Deploy only a specific target
+promptopskit skill --target copilot
 
-# Overwrite an existing instructions file
+# Overwrite existing instructions files
 promptopskit skill --force
 ```
 
-The deployed file covers the prompt format, front matter schema, variable interpolation, includes, overrides, the TypeScript API, provider adapters, and project conventions — everything an AI agent needs to write correct prompts on the first try.
+The `CLAUDE.md` file uses Claude Code's `@AGENTS.md` import syntax to avoid duplicating content. The deployed files cover the prompt format, front matter schema, variable interpolation, includes, overrides, the TypeScript API, provider adapters, and project conventions — everything an AI agent needs to write correct prompts on the first try.
 
 ## Inline Source
 

package/dist/{chunk-QDGJFINW.js → chunk-CX6KVBW4.js}

@@ -63,6 +63,8 @@ var SectionsSchema = z.object({
   notes: z.string().optional()
 });
 var PromptDefaultsSchema = z.object({
+  provider: z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  model: z.string().optional(),
   metadata: MetadataSchema.optional(),
   sections: z.object({
     system_instructions: z.string().optional()
@@ -97,7 +99,7 @@ var SECTION_MAP = {
   "notes": "notes"
 };
 function extractSections(body) {
-  const lines = body.split("\n");
+  const lines = body.split(/\r?\n/);
   const sections = {};
   let currentKey = null;
   let currentLines = [];
@@ -206,6 +208,8 @@ function parseDefaults(content) {
 }
 function mergeDefaults(base, local) {
   return {
+    provider: local.provider ?? base.provider,
+    model: local.model ?? base.model,
     metadata: {
       ...base.metadata ?? {},
       ...local.metadata ?? {}
@@ -219,7 +223,8 @@ function mergeDefaults(base, local) {
 function applyDefaults(asset, defaults) {
   const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;
   const hasDefaultSystem = !!defaults.sections?.system_instructions;
-  if (!hasDefaultMetadata && !hasDefaultSystem) {
+  const hasDefaultScalars = defaults.provider !== void 0 || defaults.model !== void 0;
+  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {
     return asset;
   }
   const mergedMetadata = {
@@ -231,6 +236,8 @@ function applyDefaults(asset, defaults) {
   const sections = asset.sections ? { ...asset.sections, system_instructions: systemInstructions } : systemInstructions ? { system_instructions: systemInstructions } : void 0;
   return {
     ...asset,
+    provider: asset.provider ?? defaults.provider,
+    model: asset.model ?? defaults.model,
     metadata,
     sections
   };
@@ -243,4 +250,4 @@ export {
   parsePrompt,
   loadPromptFile
 };
-//# sourceMappingURL=chunk-QDGJFINW.js.map
+//# sourceMappingURL=chunk-CX6KVBW4.js.map

package/dist/chunk-CX6KVBW4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/schema.ts","../src/parser/sections.ts","../src/parser/parser.ts","../src/parser/loader.ts"],"sourcesContent":["import { z } from 'zod';\n\n// --- Tool definitions ---\n\nexport const InlineToolDefSchema = z.object({\n  name: z.string(),\n  description: z.string().optional(),\n  input_schema: z.record(z.unknown()).optional(),\n});\n\nexport type InlineToolDef = z.infer<typeof InlineToolDefSchema>;\n\nexport const ToolRefSchema = z.union([z.string(), InlineToolDefSchema]);\n\n// --- MCP ---\n\nexport const MCPServerRefSchema = z.union([\n  z.string(),\n  z.object({\n    name: z.string(),\n    config: z.record(z.unknown()).optional(),\n  }),\n]);\n\nexport type MCPServerRef = z.infer<typeof MCPServerRefSchema>;\n\n// --- Reasoning ---\n\nexport const ReasoningSchema = z.object({\n  effort: z.enum(['low', 'medium', 'high']).optional(),\n  budget_tokens: z.number().int().positive().optional(),\n});\n\n// --- Sampling ---\n\nexport const SamplingSchema = z.object({\n  temperature: z.number().min(0).max(2).optional(),\n  top_p: z.number().min(0).max(1).optional(),\n  frequency_penalty: z.number().optional(),\n  presence_penalty: z.number().optional(),\n  stop: z.array(z.string()).optional(),\n  max_output_tokens: z.number().int().positive().optional(),\n});\n\n// --- Response ---\n\nexport const ResponseSchema = z.object({\n  format: z.enum(['text', 'json', 'markdown']).optional(),\n  stream: z.boolean().optional(),\n});\n\n// --- Context ---\n\nexport const HistorySchema = z.object({\n  max_items: z.number().int().positive().optional(),\n});\n\nexport const ContextSchema = z.object({\n  inputs: z.array(z.string()).optional(),\n  history: HistorySchema.optional(),\n});\n\n// --- Metadata ---\n\nexport const MetadataSchema = z.object({\n  owner: z.string().optional(),\n  tags: z.array(z.string()).optional(),\n  review_required: z.boolean().optional(),\n  stable: z.boolean().optional(),\n});\n\n// --- MCP block ---\n\nexport const MCPSchema = z.object({\n  servers: z.array(MCPServerRefSchema).optional(),\n});\n\n// --- Overrides (subset allowed in environments/tiers) ---\n\nexport const PromptAssetOverridesSchema = z.object({\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n  tools: z.array(ToolRefSchema).optional(),\n});\n\nexport type PromptAssetOverrides = z.infer<typeof PromptAssetOverridesSchema>;\n\n// --- Source tracking ---\n\nexport const SourceSchema = z.object({\n  file_path: z.string().optional(),\n  checksum: z.string().optional(),\n});\n\n// --- Sections (populated by parser) ---\n\nexport const SectionsSchema = z.object({\n  system_instructions: z.string().optional(),\n  prompt_template: z.string().optional(),\n  notes: z.string().optional(),\n});\n\n// --- Defaults files (folder-level inheritance) ---\n\nexport const PromptDefaultsSchema = z.object({\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  metadata: MetadataSchema.optional(),\n  sections: z.object({\n    system_instructions: z.string().optional(),\n  }).optional(),\n});\n\nexport type PromptDefaults = z.infer<typeof PromptDefaultsSchema>;\n\n// --- Top-level PromptAsset ---\n\nexport const PromptAssetSchema = z.object({\n  id: z.string(),\n  schema_version: z.number().int().positive().default(1),\n  description: z.string().optional(),\n\n  provider: z.enum(['openai', 'anthropic', 'google', 'gemini', 'openrouter', 'any']).optional(),\n  model: z.string().optional(),\n  fallback_models: z.array(z.string()).optional(),\n\n  reasoning: ReasoningSchema.optional(),\n  sampling: SamplingSchema.optional(),\n  response: ResponseSchema.optional(),\n\n  tools: z.array(ToolRefSchema).optional(),\n  mcp: MCPSchema.optional(),\n\n  context: ContextSchema.optional(),\n\n  includes: z.array(z.string()).optional(),\n\n  environments: z.record(PromptAssetOverridesSchema).optional(),\n  tiers: z.record(PromptAssetOverridesSchema).optional(),\n\n  metadata: MetadataSchema.optional(),\n\n  // Populated by parser, not authored in YAML\n  sections: SectionsSchema.optional(),\n  source: SourceSchema.optional(),\n});\n\nexport type PromptAsset = z.infer<typeof PromptAssetSchema>;\n\n// --- Resolved asset (after includes, overrides applied) ---\n\nexport interface ResolvedPromptAsset extends PromptAsset {\n  sections: {\n    system_instructions?: string;\n    prompt_template?: string;\n    notes?: string;\n  };\n  source: {\n    file_path?: string;\n    checksum?: string;\n  };\n}\n","export interface Sections {\n  system_instructions?: string;\n  prompt_template?: string;\n  notes?: string;\n}\n\nconst SECTION_MAP: Record<string, keyof Sections> = {\n  'system instructions': 'system_instructions',\n  'prompt template': 'prompt_template',\n  'notes': 'notes',\n};\n\n/**\n * Extract named sections from the markdown body using H1 headings.\n * Case-insensitive. H2+ within a section is treated as content.\n * If no H1 headings are found, the entire body is treated as prompt_template.\n */\nexport function extractSections(body: string): Sections {\n  const lines = body.split(/\\r?\\n/);\n  const sections: Sections = {};\n\n  let currentKey: keyof Sections | null = null;\n  let currentLines: string[] = [];\n  let foundAnyH1 = false;\n\n  for (const line of lines) {\n    const h1Match = line.match(/^#\\s+(.+)$/);\n    if (h1Match) {\n      // Flush previous section\n      if (currentKey) {\n        sections[currentKey] = currentLines.join('\\n').trim();\n      }\n\n      foundAnyH1 = true;\n      const heading = h1Match[1].trim().toLowerCase();\n      currentKey = SECTION_MAP[heading] ?? null;\n      currentLines = [];\n    } else {\n      currentLines.push(line);\n    }\n  }\n\n  // Flush last section\n  if (currentKey) {\n    sections[currentKey] = currentLines.join('\\n').trim();\n  }\n\n  // If no H1 headings found, treat entire body as prompt_template\n  if (!foundAnyH1) {\n    const trimmed = body.trim();\n    if (trimmed) {\n      sections.prompt_template = trimmed;\n    }\n  }\n\n  return sections;\n}\n","import matter from 'gray-matter';\nimport { PromptAssetSchema } from '../schema/index.js';\nimport type { PromptAsset } from '../schema/index.js';\nimport { extractSections } from './sections.js';\n\nexport interface ParseResult {\n  asset: PromptAsset;\n  raw: {\n    frontMatter: Record<string, unknown>;\n    body: string;\n  };\n}\n\n/**\n * Parse a prompt markdown string (YAML front matter + markdown body)\n * into a validated PromptAsset.\n */\nexport function parsePrompt(content: string, filePath?: string): ParseResult {\n  const { data: frontMatter, content: body } = matter(content);\n\n  const sections = extractSections(body);\n\n  const raw = {\n    ...frontMatter,\n    sections,\n    source: filePath ? { file_path: filePath } : undefined,\n  };\n\n  const asset = PromptAssetSchema.parse(raw);\n\n  return {\n    asset,\n    raw: {\n      frontMatter: frontMatter as Record<string, unknown>,\n      body,\n    },\n  };\n}\n","import { readFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport matter from 'gray-matter';\nimport { parsePrompt } from './parser.js';\nimport type { ParseResult } from './parser.js';\nimport { extractSections } from './sections.js';\nimport { PromptDefaultsSchema } from '../schema/index.js';\nimport type { PromptDefaults } from '../schema/index.js';\n\nconst DEFAULTS_FILE_NAME = 'defaults.md';\n\nexport interface LoadPromptOptions {\n  /**\n   * Optional boundary directory for defaults discovery.\n   * If provided, defaults are loaded from this directory down to the prompt directory.\n   */\n  defaultsRoot?: string;\n}\n\n/**\n * Load and parse a prompt file from disk.\n */\nexport async function loadPromptFile(filePath: string, options: LoadPromptOptions = {}): Promise<ParseResult> {\n  const content = await readFile(filePath, 'utf-8');\n  const parsed = parsePrompt(content, filePath);\n  // Default the boundary to the file's own directory so traversal never\n  // walks above the prompt tree when no explicit root is provided.\n  const root = options.defaultsRoot ?? dirname(filePath);\n  const defaults = await loadDefaultsForPath(filePath, root);\n  const asset = applyDefaults(parsed.asset, defaults);\n\n  return {\n    ...parsed,\n    asset,\n  };\n}\n\nasync function loadDefaultsForPath(filePath: string, defaultsRoot?: string): Promise<PromptDefaults> {\n  const directories = getDirectoriesToCheck(filePath, defaultsRoot);\n  let merged: PromptDefaults = {};\n\n  for (const dir of directories) {\n    const defaultsPath = join(dir, DEFAULTS_FILE_NAME);\n    try {\n      const defaultsContent = await readFile(defaultsPath, 'utf-8');\n      const defaults = parseDefaults(defaultsContent);\n      merged = mergeDefaults(merged, defaults);\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        throw error;\n      }\n    }\n  }\n\n  return merged;\n}\n\nfunction getDirectoriesToCheck(filePath: string, defaultsRoot?: string): string[] {\n  const dirs: string[] = [];\n  let current = resolve(dirname(filePath));\n  const boundary = defaultsRoot ? resolve(defaultsRoot) : undefined;\n\n  while (true) {\n    dirs.unshift(current);\n    if ((boundary && current === boundary) || current === dirname(current)) {\n      break;\n    }\n    current = dirname(current);\n  }\n\n  return dirs;\n}\n\nfunction parseDefaults(content: string): PromptDefaults {\n  const { data: frontMatter, content: body } = matter(content);\n  const sections = extractSections(body);\n\n  return PromptDefaultsSchema.parse({\n    ...frontMatter,\n    sections: {\n      system_instructions: sections.system_instructions,\n    },\n  });\n}\n\nfunction mergeDefaults(base: PromptDefaults, local: PromptDefaults): PromptDefaults {\n  return {\n    provider: local.provider ?? base.provider,\n    model: local.model ?? base.model,\n    metadata: {\n      ...(base.metadata ?? {}),\n      ...(local.metadata ?? {}),\n    },\n    sections: {\n      ...(base.sections ?? {}),\n      ...(local.sections ?? {}),\n    },\n  };\n}\n\nfunction applyDefaults(asset: ParseResult['asset'], defaults: PromptDefaults): ParseResult['asset'] {\n  const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;\n  const hasDefaultSystem = !!defaults.sections?.system_instructions;\n  const hasDefaultScalars = defaults.provider !== undefined\n    || defaults.model !== undefined;\n\n  // Short-circuit: nothing to merge\n  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {\n    return asset;\n  }\n\n  const mergedMetadata = {\n    ...(defaults.metadata ?? {}),\n    ...(asset.metadata ?? {}),\n  };\n  const metadata = Object.keys(mergedMetadata).length > 0 ? mergedMetadata : undefined;\n\n  const systemInstructions = asset.sections?.system_instructions ?? defaults.sections?.system_instructions;\n\n  const sections = asset.sections\n    ? { ...asset.sections, system_instructions: systemInstructions }\n    : systemInstructions\n      ? { system_instructions: systemInstructions }\n      : undefined;\n\n  return {\n    ...asset,\n    provider: asset.provider ?? defaults.provider,\n    model: asset.model ?? defaults.model,\n    metadata,\n    sections,\n  };\n}\n"],"mappings":"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","names":["matter","matter"]}

package/dist/cli/index.js

@@ -72,6 +72,8 @@ var SectionsSchema = z.object({
   notes: z.string().optional()
 });
 var PromptDefaultsSchema = z.object({
+  provider: z.enum(["openai", "anthropic", "google", "gemini", "openrouter", "any"]).optional(),
+  model: z.string().optional(),
   metadata: MetadataSchema.optional(),
   sections: z.object({
     system_instructions: z.string().optional()
@@ -106,7 +108,7 @@ var SECTION_MAP = {
   "notes": "notes"
 };
 function extractSections(body) {
-  const lines = body.split("\n");
+  const lines = body.split(/\r?\n/);
   const sections = {};
   let currentKey = null;
   let currentLines = [];
@@ -214,6 +216,8 @@ function parseDefaults(content) {
 }
 function mergeDefaults(base, local) {
   return {
+    provider: local.provider ?? base.provider,
+    model: local.model ?? base.model,
     metadata: {
       ...base.metadata ?? {},
       ...local.metadata ?? {}
@@ -227,7 +231,8 @@ function mergeDefaults(base, local) {
 function applyDefaults(asset, defaults) {
   const hasDefaultMetadata = defaults.metadata && Object.keys(defaults.metadata).length > 0;
   const hasDefaultSystem = !!defaults.sections?.system_instructions;
-  if (!hasDefaultMetadata && !hasDefaultSystem) {
+  const hasDefaultScalars = defaults.provider !== void 0 || defaults.model !== void 0;
+  if (!hasDefaultMetadata && !hasDefaultSystem && !hasDefaultScalars) {
     return asset;
   }
   const mergedMetadata = {
@@ -239,6 +244,8 @@ function applyDefaults(asset, defaults) {
   const sections = asset.sections ? { ...asset.sections, system_instructions: systemInstructions } : systemInstructions ? { system_instructions: systemInstructions } : void 0;
   return {
     ...asset,
+    provider: asset.provider ?? defaults.provider,
+    model: asset.model ?? defaults.model,
     metadata,
     sections
   };
@@ -796,18 +803,19 @@ Options:
 `.trim();
 var HELLO_PROMPT = `---
 id: hello
-schema_version: 1
-provider: openai
-model: gpt-5.4
 context:
   inputs:
     - name
     - app_context
 includes:
   - ./shared/tone.md
+reasoning:
+  effort: high
 environments:
   dev:
     model: gpt-5.4-mini
+    reasoning:
+      effort: low
     sampling:
       temperature: 0.2
 ---
@@ -822,7 +830,7 @@ Current app context: {{ app_context }}.
 Say hello to {{ name }} and ask how you can help them today.
 `.trimStart();
 var TONE_INCLUDE = `---
-id: shared.tone
+id: shared/tone
 schema_version: 1
 ---
 
@@ -831,6 +839,8 @@ schema_version: 1
 Always be polite, professional, and concise. Avoid jargon unless the user uses it first.
 `.trimStart();
 var DEFAULTS = `---
+provider: openai
+model: gpt-5.4
 metadata:
   owner: my-team
   review_required: true
@@ -851,7 +861,7 @@ var TEST_SIDECAR = `cases:
       app_context: "Settings page"
 `;
 var EXAMPLE_USAGE = `// Example: render the hello prompt and send it to OpenAI
-// Full docs: https://promptopskit.com/docs/#/getting-started
+// Full docs: https://promptopskit.com/docs/index.html#/
 
 import { createPromptOpsKit } from 'promptopskit';
 
@@ -859,8 +869,8 @@ async function main() {
   const kit = createPromptOpsKit({ sourceDir: './prompts' });
 
   // Determine environment from ENV var (defaults to 'dev')
-  // - dev: uses gpt-5.4-mini with temperature 0.2 (see hello.md environments)
-  // - production: uses base model gpt-5.4 with default settings
+  // - dev: uses gpt-5.4-mini, low reasoning effort, temperature 0.2
+  // - production: uses base model gpt-5.4 with high reasoning effort
   const environment = process.env.NODE_ENV === 'production' ? 'prod' : 'dev';
 
   const { request } = await kit.renderPrompt({
@@ -873,6 +883,28 @@ async function main() {
     },
   });
 
+  // request.body is the fully transformed OpenAI Chat Completions payload.
+  // For the hello.md prompt in the dev environment it looks like:
+  //
+  // {
+  //   "model": "gpt-5.4-mini",
+  //   "reasoning_effort": "low",
+  //   "temperature": 0.2,
+  //   "messages": [
+  //     {
+  //       "role": "system",
+  //       "content": "You are a friendly assistant. Be helpful and concise.
+Current app context: Welcome screen.
+
+Always be polite, professional, and concise. Avoid jargon unless the user uses it first."
+  //     },
+  //     {
+  //       "role": "user",
+  //       "content": "Say hello to World and ask how you can help them today."
+  //     }
+  //   ]
+  // }
+
   console.log('Model:', request.body.model);
 
   const res = await fetch('https://api.openai.com/v1/chat/completions', {
@@ -941,17 +973,27 @@ promptopskit skill [--target <target>] [--force]
 Deploy AI agent instructions so coding assistants know how to
 create and manage prompts using promptopskit.
 
-Targets:
-  copilot   (default) .github/instructions/promptopskit.instructions.md
-  cursor    .cursor/rules/promptopskit.mdc
-  generic   .ai/promptopskit-skill.md
+By default, generates files for all major AI coding assistants:
+
+  AGENTS.md                                          Codex, OpenCode, Cursor, Copilot
+  CLAUDE.md                                          Claude Code (imports AGENTS.md)
+  .github/instructions/promptopskit.instructions.md  GitHub Copilot (path-specific)
+  .cursor/rules/promptopskit.mdc                     Cursor (project rule)
 
 Options:
-  --target, -t     Target AI tool (copilot, cursor, generic)
-  --force, -f      Overwrite existing file
+  --target, -t     Deploy only a specific target (agents, claude, copilot, cursor)
+  --force, -f      Overwrite existing files
   --help, -h       Show this help
 `.trim();
 var TARGETS = {
+  agents: {
+    path: "AGENTS.md",
+    wrap: (content) => content
+  },
+  claude: {
+    path: "CLAUDE.md",
+    wrap: () => "@AGENTS.md\n"
+  },
   copilot: {
     path: ".github/instructions/promptopskit.instructions.md",
     wrap: (content) => `---
@@ -969,40 +1011,45 @@ alwaysApply: true
 ---
 
 ${content}`
-  },
-  generic: {
-    path: ".ai/promptopskit-skill.md",
-    wrap: (content) => content
   }
 };
+var ALL_TARGETS = ["agents", "claude", "copilot", "cursor"];
 async function skill(args) {
   if (args.includes("--help") || args.includes("-h")) {
     console.log(HELP6);
     return;
   }
   const force = args.includes("--force") || args.includes("-f");
-  let target = "copilot";
+  let targets = ALL_TARGETS;
   const targetIdx = args.findIndex((a) => a === "--target" || a === "-t");
   if (targetIdx !== -1 && args[targetIdx + 1]) {
-    target = args[targetIdx + 1];
-  }
-  const config = TARGETS[target];
-  if (!config) {
-    console.error(`Unknown target: ${target}`);
-    console.error(`Valid targets: ${Object.keys(TARGETS).join(", ")}`);
-    process.exit(1);
+    const target = args[targetIdx + 1];
+    const config = TARGETS[target];
+    if (!config) {
+      console.error(`Unknown target: ${target}`);
+      console.error(`Valid targets: ${Object.keys(TARGETS).join(", ")}`);
+      process.exit(1);
+    }
+    targets = [target];
+  }
+  let written = 0;
+  for (const target of targets) {
+    const config = TARGETS[target];
+    const filePath = config.path;
+    if (existsSync3(filePath) && !force) {
+      console.log(`  skip ${filePath} (already exists, use --force to overwrite)`);
+      continue;
+    }
+    const content = config.wrap(SKILL_CONTENT);
+    await mkdir3(dirname5(filePath), { recursive: true });
+    await writeFile3(filePath, content, "utf-8");
+    console.log(`  \u2713 ${filePath}`);
+    written++;
   }
-  const filePath = config.path;
-  if (existsSync3(filePath) && !force) {
-    console.log(`  skip ${filePath} (already exists, use --force to overwrite)`);
-    return;
+  if (written > 0) {
+    console.log();
+    console.log(`AI agents will now understand how to create and manage prompts with promptopskit.`);
   }
-  const content = config.wrap(SKILL_CONTENT);
-  await mkdir3(dirname5(filePath), { recursive: true });
-  await writeFile3(filePath, content, "utf-8");
-  console.log(`  \u2713 ${filePath}`);
-  console.log();
-  console.log(`AI agents will now understand how to create and manage prompts with promptopskit.`);
 }
 var SKILL_CONTENT = `# promptopskit \u2014 Prompt Engineering Skill
 
@@ -1122,16 +1169,21 @@ folder:
 
 \`\`\`text
 prompts/
-\u251C\u2500\u2500 defaults.md          # global metadata + system instructions
+\u251C\u2500\u2500 defaults.md          # global provider, model, metadata + system instructions
 \u2514\u2500\u2500 support/
     \u251C\u2500\u2500 defaults.md      # overrides for support/*
     \u2514\u2500\u2500 reply.md         # inherits from support/defaults.md
 \`\`\`
 
 Supported default fields:
+- \`provider\` (front matter) \u2014 default provider for the folder
+- \`model\` (front matter) \u2014 default model for the folder
 - \`metadata\` (front matter) \u2014 merged with prompt-local metadata
 - \`# System instructions\` (body section) \u2014 used when the prompt has none
 
+This lets you configure app-wide settings like \`provider\` and \`model\`
+in a single root \`defaults.md\`, so individual prompts only declare what\u2019s unique to them.
+
 Rules:
 - Nearest subfolder \`defaults.md\` overrides parent defaults
 - Prompt-local values always take precedence over defaults
@@ -1149,10 +1201,14 @@ Override model settings per environment or tier:
 environments:
   development:
     model: gpt-4.1-mini
+    reasoning:
+      effort: low
     sampling:
       temperature: 0.9
   production:
     model: gpt-5.4
+    reasoning:
+      effort: high
     sampling:
       temperature: 0.3
 
@@ -1312,14 +1368,14 @@ Hello {{ name }}
 ## Conventions to follow
 
 1. **One prompt per file** \u2014 each \`.md\` file is a single prompt asset
-2. **Always set \`id\` and \`schema_version: 1\`** in front matter
+2. **Always set \`id\` and \`schema_version: 1\`** in front matter (or inherit \`schema_version\` from \`defaults.md\`)
 3. **Declare all variables** in \`context.inputs\` that appear in templates
 4. **Use includes** for shared system instructions (tone, safety, formatting)
 5. **Keep prompt templates focused** \u2014 compose behavior via includes, not duplication
 6. **Use environment overrides** for dev/staging/prod model differences
 7. **Add test sidecars** (\`.test.yaml\`) for critical prompts
 8. **Run \`promptopskit validate\`** before committing changes
-9. **Use \`defaults.md\`** to share metadata and system instructions across a folder
+9. **Use \`defaults.md\`** to share provider, model, metadata, and system instructions across a folder
 10. **Variable names** should be \`snake_case\`
 11. **Prompt file names** should be \`kebab-case.md\`
 `.trimEnd();