skilld 1.0.0 → 1.1.0

package/dist/_chunks/prompts.mjs

@@ -1,734 +1,9 @@
 import { n as sanitizeMarkdown, t as repairMarkdown } from "./sanitize.mjs";
 import { t as yamlEscape } from "./yaml.mjs";
 import { i as resolveSkilldCommand, l as getFilePatterns, u as getPackageRules } from "./shared.mjs";
-import { homedir } from "node:os";
+import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
 import { dirname, join, relative } from "pathe";
 import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { isWindows } from "std-env";
-/** Common frontmatter fields from agentskills.io spec */
-const SPEC_FRONTMATTER = {
-	"name": {
-		name: "name",
-		required: true,
-		description: "Skill identifier. Must match parent directory name.",
-		constraints: "1-64 chars, lowercase alphanumeric + hyphens"
-	},
-	"description": {
-		name: "description",
-		required: true,
-		description: "What the skill does and when to use it.",
-		constraints: "1-1024 chars"
-	},
-	"license": {
-		name: "license",
-		required: false,
-		description: "License reference"
-	},
-	"compatibility": {
-		name: "compatibility",
-		required: false,
-		description: "Environment requirements",
-		constraints: "max 500 chars"
-	},
-	"metadata": {
-		name: "metadata",
-		required: false,
-		description: "Arbitrary key-value pairs"
-	},
-	"allowed-tools": {
-		name: "allowed-tools",
-		required: false,
-		description: "Space-delimited pre-approved tools (experimental)"
-	}
-};
-/** Shared defaults for all agent targets */
-const BASE_DEFAULTS = {
-	skillFilename: "SKILL.md",
-	nameMatchesDir: true,
-	namePattern: "^[a-z0-9]+(-[a-z0-9]+)*$",
-	additionalSkillsDirs: [],
-	extensions: [],
-	notes: []
-};
-/** Define an agent target with shared defaults applied */
-function defineTarget(target) {
-	return {
-		...BASE_DEFAULTS,
-		...target
-	};
-}
-const configHome$2 = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-/**
-* Amp (Sourcegraph)
-*
-* Uses .agents/skills/ as primary project path. Also reads .claude/skills/.
-* Skills can bundle MCP servers via mcp.json in the skill directory.
-*
-* AGENTS.md (or AGENT.md / CLAUDE.md fallback) for general instructions,
-* supports @-mentions to reference other files and glob-based conditional includes.
-*
-* @see https://ampcode.com/news/agent-skills
-* @see https://ampcode.com/manual
-*/
-const amp = defineTarget({
-	agent: "amp",
-	displayName: "Amp",
-	detectInstalled: () => existsSync(join(configHome$2, "amp")),
-	detectEnv: () => !!process.env.AMP_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".agents", "AGENTS.md")),
-	instructionFile: "AGENTS.md",
-	skillsDir: ".agents/skills",
-	globalSkillsDir: join(configHome$2, "agents/skills"),
-	additionalSkillsDirs: [
-		".claude/skills",
-		"~/.config/amp/skills",
-		"~/.claude/skills"
-	],
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Unique identifier. Project skills override user-wide ones with same name."
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "Always visible to the model; determines when skill is invoked."
-	}],
-	discoveryStrategy: "lazy",
-	discoveryNotes: "Names + descriptions visible at startup. Full SKILL.md body loads only when agent decides to invoke based on description match.",
-	agentSkillsSpec: false,
-	extensions: ["mcp.json for bundling MCP server configurations"],
-	docs: "https://ampcode.com/news/agent-skills",
-	notes: [
-		"Reads .claude/skills/ natively — emitting there covers Claude Code, Cursor, Cline, Copilot, AND Amp.",
-		"Skills can bundle MCP servers via mcp.json in the skill directory.",
-		"AGENTS.md supports @-mentions to reference files (e.g. @doc/style.md, @doc/*.md globs).",
-		"AGENTS.md files with globs frontmatter are conditionally included only when Amp reads matching files."
-	]
-});
-const home$6 = homedir();
-/**
-* Antigravity (Google)
-*
-* Agent-first IDE (VS Code fork) powered by Gemini. Skills live in
-* .agent/skills/ (workspace) or ~/.gemini/antigravity/skills/ (global).
-* Uses semantic matching on description to auto-invoke skills.
-*
-* Adopted the Agent Skills open standard (agentskills.io) in Jan 2026.
-* Only `name` and `description` are used for routing; body loads on demand.
-*
-* @see https://antigravity.google/docs/skills
-* @see https://codelabs.developers.google.com/getting-started-with-antigravity-skills
-*/
-const antigravity = defineTarget({
-	agent: "antigravity",
-	displayName: "Antigravity",
-	detectInstalled: () => existsSync(join(home$6, ".gemini/antigravity")),
-	detectEnv: () => !!process.env.ANTIGRAVITY_CLI_ALIAS,
-	detectProject: (cwd) => existsSync(join(cwd, ".agent")),
-	instructionFile: "GEMINI.md",
-	skillsDir: ".agent/skills",
-	globalSkillsDir: join(home$6, ".gemini/antigravity/skills"),
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Skill identifier. Defaults to directory name if omitted."
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "Semantic trigger for agent routing. Must be descriptive enough for LLM matching."
-	}],
-	discoveryStrategy: "lazy",
-	discoveryNotes: "Indexes name + description at startup. Full SKILL.md body loads on demand when agent semantic-matches description against user prompt.",
-	agentSkillsSpec: true,
-	docs: "https://antigravity.google/docs/skills",
-	notes: [
-		"Only `name` and `description` are used for routing; other frontmatter fields are accepted but not used for matching.",
-		"Skill directories can include scripts/, resources/, and assets/ subdirectories for supporting files.",
-		"GEMINI.md instruction file is shared with Gemini CLI. .agent/rules/*.md for always-on workspace rules."
-	]
-});
-const claudeHome = process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
-/**
-* Claude Code (Anthropic CLI)
-*
-* Follows the Agent Skills open standard (agentskills.io) plus Claude-specific
-* extensions like `disable-model-invocation`, `user-invocable`, `context`, etc.
-*
-* Skills are discovered at startup — only `name` + `description` are read initially.
-* Full SKILL.md body loads when the agent invokes the skill (via Skill tool or auto-match).
-*
-* @see https://code.claude.com/docs/en/skills
-* @see https://agentskills.io/specification
-*/
-const claudeCode = defineTarget({
-	agent: "claude-code",
-	displayName: "Claude Code",
-	detectInstalled: () => existsSync(claudeHome),
-	detectEnv: () => !!(process.env.CLAUDE_CODE || process.env.CLAUDECODE || process.env.CLAUDE_CODE_ENTRYPOINT || process.env.CLAUDE_CONFIG_DIR),
-	detectProject: (cwd) => existsSync(join(cwd, ".claude")) || existsSync(join(cwd, "CLAUDE.md")),
-	cli: "claude",
-	instructionFile: "CLAUDE.md",
-	skillsDir: ".claude/skills",
-	globalSkillsDir: join(claudeHome, "skills"),
-	frontmatter: [
-		{
-			...SPEC_FRONTMATTER.name,
-			required: false,
-			description: "Skill identifier, becomes /slash-command. Defaults to directory name if omitted.",
-			constraints: "1-64 chars, ^[a-z0-9]+(-[a-z0-9]+)*$"
-		},
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "What the skill does and when to use it. Used for auto-discovery matching."
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER.compatibility,
-		SPEC_FRONTMATTER.metadata,
-		SPEC_FRONTMATTER["allowed-tools"],
-		{
-			name: "disable-model-invocation",
-			required: false,
-			description: "When true, skill only loads via explicit /name invocation"
-		},
-		{
-			name: "user-invocable",
-			required: false,
-			description: "When false, hides from / menu but still auto-loads"
-		},
-		{
-			name: "argument-hint",
-			required: false,
-			description: "Hint shown during autocomplete, e.g. [issue-number]"
-		},
-		{
-			name: "model",
-			required: false,
-			description: "Model to use when skill is active"
-		},
-		{
-			name: "context",
-			required: false,
-			description: "Set to \"fork\" to run in a forked subagent context"
-		},
-		{
-			name: "agent",
-			required: false,
-			description: "Subagent type when context: fork (e.g. Explore, Plan)"
-		}
-	],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Scans skill dirs at startup, reads name + description only. Full body loads on invocation. Budget: 2% of context window for all skill descriptions.",
-	agentSkillsSpec: true,
-	extensions: [
-		"disable-model-invocation",
-		"user-invocable",
-		"argument-hint",
-		"model",
-		"context",
-		"agent",
-		"hooks",
-		"$ARGUMENTS substitution",
-		"!`command` dynamic context"
-	],
-	docs: "https://code.claude.com/docs/en/skills",
-	notes: [
-		"`globs` is NOT a valid frontmatter field for skills (only for rules). Unknown fields are silently ignored.",
-		"`version` and `generated_by` should go under `metadata` map, not as top-level fields.",
-		"Skill descriptions have a char budget of 2% of context window (~16k chars fallback). Override with SLASH_COMMAND_TOOL_CHAR_BUDGET env var.",
-		"Keep SKILL.md under 500 lines. Move detailed reference to separate files.",
-		"Supports monorepo auto-discovery: nested .claude/skills/ dirs in subdirectories.",
-		"Supporting dirs: scripts/, references/, assets/ alongside SKILL.md."
-	]
-});
-const home$5 = homedir();
-/**
-* Cline (VS Code extension)
-*
-* Has TWO systems: Rules (.clinerules/) and Skills (.cline/skills/).
-* We target Skills. Cline also reads .claude/skills/ as a fallback,
-* so emitting to .claude/skills/ covers both Claude Code and Cline.
-*
-* Only `name` and `description` are parsed from frontmatter.
-* All other fields are stripped/ignored.
-*
-* @see https://docs.cline.bot/features/skills
-* @see https://docs.cline.bot/features/cline-rules
-*/
-const cline = defineTarget({
-	agent: "cline",
-	displayName: "Cline",
-	detectInstalled: () => existsSync(join(home$5, ".cline")),
-	detectEnv: () => !!process.env.CLINE_TASK_ID,
-	detectProject: (cwd) => existsSync(join(cwd, ".cline")),
-	instructionFile: ".clinerules",
-	skillsDir: ".cline/skills",
-	globalSkillsDir: join(home$5, ".cline/skills"),
-	additionalSkillsDirs: [".clinerules/skills", ".claude/skills"],
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Must exactly match the directory name."
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "When to activate. Used for matching."
-	}],
-	discoveryStrategy: "eager",
-	discoveryNotes: "At startup reads name + description from each skill. Full content loads on-demand via use_skill tool. Dozens of skills have near-zero context cost.",
-	agentSkillsSpec: false,
-	docs: "https://docs.cline.bot/features/skills",
-	notes: [
-		"Only `name` and `description` are parsed. `version`, `globs`, etc. are silently ignored.",
-		"Cline reads .claude/skills/ as a fallback — emitting there covers both Claude Code and Cline.",
-		"Rules system (.clinerules/) is separate: always-on behavioral constraints with globs/tags frontmatter.",
-		"Global skills override project skills when names conflict.",
-		"Supporting dirs: docs/, scripts/, templates/ alongside SKILL.md."
-	]
-});
-const codexHome = process.env.CODEX_HOME || join(homedir(), ".codex");
-/**
-* OpenAI Codex CLI
-*
-* IMPORTANT: Codex uses `.agents/skills/` for project-level skills,
-* NOT `.codex/skills/`. The `.codex/` directory is for config (config.toml).
-* `~/.codex/skills/` works only as a legacy user-global path.
-*
-* Codex also has AGENTS.md (or AGENTS.override.md) for general instructions,
-* which walks from git root to CWD concatenating found files.
-*
-* @see https://developers.openai.com/codex/skills
-* @see https://developers.openai.com/codex/guides/agents-md/
-*/
-const codex = defineTarget({
-	agent: "codex",
-	displayName: "Codex",
-	detectInstalled: () => existsSync(codexHome),
-	detectEnv: () => !!(process.env.CODEX_HOME || process.env.CODEX_SESSION),
-	detectProject: (cwd) => existsSync(join(cwd, ".codex")),
-	cli: "codex",
-	instructionFile: "AGENTS.md",
-	skillsDir: ".agents/skills",
-	globalSkillsDir: join(homedir(), ".agents/skills"),
-	additionalSkillsDirs: ["~/.codex/skills", "/etc/codex/skills"],
-	frontmatter: [
-		{
-			...SPEC_FRONTMATTER.name,
-			description: "Skill identifier.",
-			constraints: "1-64 chars, ^[a-z0-9-]+$, no leading/trailing/consecutive hyphens"
-		},
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "Must include when-to-use criteria. Primary triggering mechanism.",
-			constraints: "1-1024 chars, no angle brackets (< or >)"
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER["allowed-tools"],
-		SPEC_FRONTMATTER.metadata
-	],
-	discoveryStrategy: "lazy",
-	discoveryNotes: "Startup scan reads name + description + optional agents/openai.yaml. Full body loads only on invocation. Supports $1-$9 and $ARGUMENTS placeholders.",
-	agentSkillsSpec: true,
-	extensions: [
-		"agents/openai.yaml (UI metadata + MCP dependencies)",
-		"$1-$9 positional argument placeholders",
-		"AGENTS.override.md for temporary overrides"
-	],
-	docs: "https://developers.openai.com/codex/skills",
-	notes: [
-		"BUG IN CURRENT CODE: skillsDir is .codex/skills/ but should be .agents/skills/. The .codex/ directory is for config, not skills.",
-		"Description field cannot contain angle brackets (< or >).",
-		"Optional agents/openai.yaml provides UI metadata: display_name, icon, brand_color, default_prompt.",
-		"AGENTS.md walks from git root to CWD, concatenating all found files.",
-		"Live reload: detects skill file changes without restart (v0.95.0+).",
-		"Size limit: 32 KiB default (project_doc_max_bytes), configurable in ~/.codex/config.toml."
-	]
-});
-const home$4 = homedir();
-/**
-* Cursor (AI code editor)
-*
-* Has TWO systems: Rules (.cursor/rules/*.mdc) and Skills (.cursor/skills/).
-* We target the Skills system which follows the Agent Skills spec.
-*
-* Cursor natively scans .claude/skills/ and .codex/skills/ in addition to
-* its own .cursor/skills/ — so .claude/skills/ output works for both
-* Claude Code and Cursor with zero duplication.
-*
-* @see https://cursor.com/docs/context/skills
-* @see https://cursor.com/docs/context/rules
-*/
-const cursor = defineTarget({
-	agent: "cursor",
-	displayName: "Cursor",
-	detectInstalled: () => existsSync(join(home$4, ".cursor")),
-	detectEnv: () => !!(process.env.CURSOR_SESSION || process.env.CURSOR_TRACE_ID),
-	detectProject: (cwd) => existsSync(join(cwd, ".cursor")) || existsSync(join(cwd, ".cursorrules")),
-	instructionFile: ".cursorrules",
-	skillsDir: ".cursor/skills",
-	globalSkillsDir: join(home$4, ".cursor/skills"),
-	additionalSkillsDirs: [
-		".claude/skills",
-		".codex/skills",
-		"~/.claude/skills",
-		"~/.codex/skills"
-	],
-	frontmatter: [
-		SPEC_FRONTMATTER.name,
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "Agent uses this to decide relevance for auto-invocation."
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER.compatibility,
-		SPEC_FRONTMATTER.metadata,
-		{
-			name: "disable-model-invocation",
-			required: false,
-			description: "When true, only loads via explicit /skill-name"
-		}
-	],
-	discoveryStrategy: "lazy",
-	discoveryNotes: "Reads name + description at conversation start. Full SKILL.md body loads only when agent determines relevance. Users can also invoke via /skill-name.",
-	agentSkillsSpec: true,
-	extensions: ["disable-model-invocation"],
-	docs: "https://cursor.com/docs/context/skills",
-	notes: [
-		"Cursor scans .claude/skills/ and .codex/skills/ natively — emitting to .claude/skills/ covers both Claude Code and Cursor.",
-		"The Rules system (.cursor/rules/*.mdc) is separate and uses different frontmatter (trigger, globs, alwaysApply).",
-		"Skills appear in Settings > Rules > Agent Decides section.",
-		"Supporting dirs: scripts/, references/, assets/ alongside SKILL.md."
-	]
-});
-const home$3 = homedir();
-/**
-* Google Gemini CLI
-*
-* Follows the Agent Skills open standard (agentskills.io).
-* Skills are activated via `activate_skill` tool with user confirmation.
-*
-* Also has GEMINI.md context files (analogous to CLAUDE.md) which support
-* @file.md import syntax for modular composition.
-*
-* @see https://geminicli.com/docs/cli/skills/
-* @see https://geminicli.com/docs/cli/creating-skills/
-*/
-const geminiCli = defineTarget({
-	agent: "gemini-cli",
-	displayName: "Gemini CLI",
-	detectInstalled: () => existsSync(join(home$3, ".gemini")),
-	detectEnv: () => !!(process.env.GEMINI_API_KEY && process.env.GEMINI_SESSION),
-	detectProject: (cwd) => existsSync(join(cwd, ".gemini")) || existsSync(join(cwd, "AGENTS.md")),
-	cli: "gemini",
-	instructionFile: "GEMINI.md",
-	skillsDir: ".gemini/skills",
-	globalSkillsDir: join(home$3, ".gemini/skills"),
-	frontmatter: [
-		SPEC_FRONTMATTER.name,
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "Primary trigger — agent uses this to match tasks."
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER.compatibility,
-		SPEC_FRONTMATTER.metadata,
-		SPEC_FRONTMATTER["allowed-tools"]
-	],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Scans at session start, injects ~100 tokens per skill (name+description). Activation via activate_skill tool requires user confirmation. Skill stays active for session duration.",
-	agentSkillsSpec: true,
-	docs: "https://geminicli.com/docs/cli/skills/",
-	notes: [
-		"Management commands: /skills list, /skills enable <name>, /skills disable <name>, /skills reload.",
-		"GEMINI.md context files are separate from skills — support @file.md import syntax.",
-		"settings.json can configure additional context filenames: [\"AGENTS.md\", \"CONTEXT.md\", \"GEMINI.md\"].",
-		"scripts/, references/, assets/ directories are defined by spec but implementation is still incomplete (issue #15895)."
-	]
-});
-const home$2 = homedir();
-/**
-* GitHub Copilot
-*
-* Has TWO systems: Instructions (.github/instructions/*.instructions.md)
-* and Skills (.github/skills/). We target Skills.
-*
-* Copilot also auto-detects .claude/skills/ as a legacy path,
-* so .claude/skills/ output works for Claude Code, Cursor, Cline, AND Copilot.
-*
-* @see https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
-* @see https://docs.github.com/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot
-*/
-const githubCopilot = defineTarget({
-	agent: "github-copilot",
-	displayName: "GitHub Copilot",
-	detectInstalled: () => existsSync(join(home$2, ".copilot")),
-	detectEnv: () => !!process.env.GITHUB_COPILOT_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".github", "copilot-instructions.md")),
-	instructionFile: ".github/copilot-instructions.md",
-	skillsDir: ".github/skills",
-	globalSkillsDir: join(home$2, ".copilot/skills"),
-	additionalSkillsDirs: [".claude/skills", "~/.claude/skills"],
-	frontmatter: [
-		SPEC_FRONTMATTER.name,
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "What the skill does AND when to use it."
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER.compatibility,
-		{
-			...SPEC_FRONTMATTER.metadata,
-			description: "Arbitrary key-value pairs (e.g. version, author)"
-		},
-		SPEC_FRONTMATTER["allowed-tools"]
-	],
-	discoveryStrategy: "lazy",
-	discoveryNotes: "3-level progressive disclosure: (1) ~100 tokens for name+description, (2) full SKILL.md body <5000 tokens on activation, (3) resources from scripts/references/assets/ on demand.",
-	agentSkillsSpec: true,
-	docs: "https://docs.github.com/en/copilot/concepts/agents/about-agent-skills",
-	notes: [
-		"Copilot auto-detects .claude/skills/ as a legacy path — emitting there covers multiple agents.",
-		"Instructions system (.github/instructions/*.instructions.md) is separate, uses applyTo globs.",
-		"copilot-instructions.md at .github/ root is always applied (repo-wide).",
-		"AGENTS.md also recognized as of Aug 2025.",
-		"excludeAgent property in instructions can hide from code-review or coding-agent.",
-		"Keep SKILL.md under 500 lines / 5000 tokens for optimal loading."
-	]
-});
-const configHome$1 = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-/**
-* Goose (Block)
-*
-* Scans 6 directories for skills, including .claude/skills/ and .agents/skills/
-* for cross-agent compatibility. Later directories override earlier ones on
-* name conflict.
-*
-* @see https://block.github.io/goose/docs/guides/context-engineering/using-skills/
-*/
-const goose = defineTarget({
-	agent: "goose",
-	displayName: "Goose",
-	detectInstalled: () => existsSync(join(configHome$1, "goose")),
-	detectEnv: () => !!process.env.GOOSE_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".goose")),
-	cli: "goose",
-	instructionFile: ".goosehints",
-	skillsDir: ".goose/skills",
-	globalSkillsDir: join(configHome$1, "goose/skills"),
-	additionalSkillsDirs: [
-		".claude/skills",
-		".agents/skills",
-		"~/.claude/skills",
-		"~/.config/agents/skills"
-	],
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Skill identifier."
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "Brief purpose statement; used for matching."
-	}],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Scans all 6 directories at startup, merges discovered skills. Later directories override earlier ones on name conflict.",
-	agentSkillsSpec: false,
-	docs: "https://block.github.io/goose/docs/guides/context-engineering/using-skills/",
-	notes: [
-		"Reads .claude/skills/ natively — emitting there covers both Claude Code and Goose.",
-		"Also supports .goosehints / .goosehints.local for general project instructions (separate from skills).",
-		"Supporting files alongside SKILL.md (scripts, templates, configs) are accessible."
-	]
-});
-const configHome = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-/**
-* OpenCode (SST)
-*
-* Walks from CWD up to git worktree root searching for skill dirs.
-* Reads .claude/skills/ and .agents/skills/ in addition to .opencode/skills/.
-*
-* Has a rich agent system: .opencode/agents/ with per-agent model/tool configuration.
-* Skills can be permission-controlled per-agent with allow/deny/ask + glob patterns.
-*
-* @see https://opencode.ai/docs/skills/
-* @see https://opencode.ai/docs/rules/
-*/
-const opencode = defineTarget({
-	agent: "opencode",
-	displayName: "OpenCode",
-	detectInstalled: () => existsSync(join(configHome, "opencode")),
-	detectEnv: () => !!process.env.OPENCODE_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".opencode")),
-	instructionFile: "AGENTS.md",
-	skillsDir: ".opencode/skills",
-	globalSkillsDir: join(configHome, "opencode/skills"),
-	additionalSkillsDirs: [
-		".claude/skills",
-		".agents/skills",
-		"~/.claude/skills",
-		"~/.agents/skills"
-	],
-	frontmatter: [
-		{
-			...SPEC_FRONTMATTER.name,
-			description: "Must match directory name."
-		},
-		{
-			...SPEC_FRONTMATTER.description,
-			description: "Used for matching."
-		},
-		SPEC_FRONTMATTER.license,
-		SPEC_FRONTMATTER.compatibility,
-		SPEC_FRONTMATTER.metadata
-	],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Walks from CWD to git worktree root, then loads global definitions. Agents access skills via native skill tool. Skills can be permission-controlled per-agent.",
-	agentSkillsSpec: true,
-	extensions: ["Per-agent skill permissions (allow/deny/ask with glob patterns)"],
-	docs: "https://opencode.ai/docs/skills/",
-	notes: [
-		"Reads .claude/skills/ and .agents/skills/ natively — emitting to .claude/skills/ covers multiple agents.",
-		"Custom agents in .opencode/agents/ have rich config: model, temperature, tools, permission, color.",
-		"opencode.json supports an instructions field with glob patterns pointing to instruction files.",
-		"AGENTS.md (or CLAUDE.md fallback) for general instructions."
-	]
-});
-const home$1 = homedir();
-/**
-* Roo Code (VS Code extension)
-*
-* IMPORTANT: Roo does NOT read .claude/skills/ or .agents/skills/.
-* It requires its own .roo/skills/ directory — no cross-compat shortcuts.
-*
-* Unique feature: mode-specific skill directories (.roo/skills-{modeSlug}/)
-* allow targeting skills to specific modes (code, architect, etc.).
-*
-* @see https://docs.roocode.com/features/skills
-* @see https://docs.roocode.com/features/custom-instructions
-*/
-const roo = defineTarget({
-	agent: "roo",
-	displayName: "Roo Code",
-	detectInstalled: () => existsSync(join(home$1, ".roo")),
-	detectEnv: () => !!process.env.ROO_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".roo")),
-	instructionFile: ".roorules",
-	skillsDir: ".roo/skills",
-	globalSkillsDir: join(home$1, ".roo/skills"),
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Must exactly match the directory name."
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "When to activate."
-	}],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Reads all SKILL.md files at startup. File watchers detect changes during session. Uses read_file to load full content on activation.",
-	agentSkillsSpec: false,
-	extensions: ["Mode-specific skill directories: .roo/skills-{modeSlug}/"],
-	docs: "https://docs.roocode.com/features/skills",
-	notes: [
-		"Does NOT read .claude/skills/ or .agents/skills/ — requires its own .roo/skills/ directory.",
-		"Mode-specific dirs: .roo/skills-code/, .roo/skills-architect/ etc. target specific modes.",
-		"Override priority: project mode-specific > project generic > global mode-specific > global generic.",
-		"Supports symlinks for shared skill libraries across projects.",
-		"Rules system (.roo/rules/) is separate — .md/.txt files loaded alphabetically into system prompt.",
-		"Legacy fallback: .roorules file if .roo/rules/ is empty.",
-		"Skills manageable from Settings panel (v3.46.0+)."
-	]
-});
-const home = homedir();
-/**
-* Windsurf (Codeium editor)
-*
-* Has TWO systems: Rules (.windsurf/rules/*.md) and Skills (.windsurf/skills/).
-* We target Skills. Rules have a separate frontmatter schema with trigger/globs.
-*
-* Skills only document `name` and `description` as frontmatter fields.
-* Cascade uses "progressive disclosure" for supporting files.
-*
-* @see https://docs.windsurf.com/windsurf/cascade/skills
-* @see https://docs.windsurf.com/windsurf/cascade/memories
-*/
-const windsurf = defineTarget({
-	agent: "windsurf",
-	displayName: "Windsurf",
-	detectInstalled: () => existsSync(join(home, ".codeium/windsurf")),
-	detectEnv: () => !!process.env.WINDSURF_SESSION,
-	detectProject: (cwd) => existsSync(join(cwd, ".windsurf")) || existsSync(join(cwd, ".windsurfrules")),
-	instructionFile: ".windsurfrules",
-	skillsDir: ".windsurf/skills",
-	globalSkillsDir: join(home, ".codeium/windsurf/skills"),
-	frontmatter: [{
-		...SPEC_FRONTMATTER.name,
-		description: "Skill identifier.",
-		constraints: "Lowercase, numbers, hyphens only"
-	}, {
-		...SPEC_FRONTMATTER.description,
-		description: "Used by Cascade for automatic invocation matching."
-	}],
-	discoveryStrategy: "eager",
-	discoveryNotes: "Cascade matches description against user requests for auto-invocation. Manual invocation via @skill-name.",
-	agentSkillsSpec: false,
-	docs: "https://docs.windsurf.com/windsurf/cascade/skills",
-	notes: [
-		"Only `name` and `description` are documented as frontmatter fields. Other fields may be silently ignored.",
-		"Rules system is separate: .windsurf/rules/*.md with trigger/globs/alwaysApply frontmatter.",
-		"Rules have a 6,000 char per-file limit and 12,000 char total limit. Skills have no documented limit.",
-		"Legacy .windsurfrules at project root still supported but deprecated.",
-		"Supporting files alongside SKILL.md are loaded via progressive disclosure."
-	]
-});
-const targets = {
-	"claude-code": claudeCode,
-	"cursor": cursor,
-	"windsurf": windsurf,
-	"cline": cline,
-	"codex": codex,
-	"github-copilot": githubCopilot,
-	"gemini-cli": geminiCli,
-	"goose": goose,
-	"amp": amp,
-	"opencode": opencode,
-	"roo": roo,
-	"antigravity": antigravity
-};
-/**
-* Detect which agents are installed on the system
-*/
-function detectInstalledAgents() {
-	return Object.entries(targets).filter(([_, config]) => config.detectInstalled()).map(([type]) => type);
-}
-/**
-* Detect the target agent (where skills are installed) from env vars and cwd.
-* This is NOT the generator LLM — it determines the skills directory.
-*
-* Priority: env vars first (running inside agent), then project dirs.
-* Iteration order of the agents record determines priority.
-*/
-function detectTargetAgent() {
-	for (const [type, target] of Object.entries(targets)) if (target.detectEnv()) return type;
-	const cwd = process.cwd();
-	for (const [type, target] of Object.entries(targets)) if (target.detectProject(cwd)) return type;
-	return null;
-}
-/**
-* Get the version of an agent's CLI (if available)
-*/
-function getAgentVersion(agentType) {
-	const agent = targets[agentType];
-	if (!agent.cli) return null;
-	try {
-		const result = spawnSync(agent.cli, ["--version"], {
-			encoding: "utf-8",
-			timeout: 3e3,
-			stdio: [
-				"pipe",
-				"pipe",
-				"pipe"
-			],
-			shell: isWindows
-		});
-		if (result.status !== 0) return null;
-		const output = (result.stdout || "").trim();
-		const match = output.match(/v?(\d+\.\d+\.\d+(?:-[a-z0-9.]+)?)/);
-		return match ? match[1] : output.split("\n")[0];
-	} catch {
-		return null;
-	}
-}
 /**
 * Dynamic budget allocation for skill sections.
 *
@@ -876,7 +151,7 @@ The "Older" column means ≤ v${Number(major) - 2}.x — these changes are NOT u
 			const labeledBullets = (content.match(/^- (?:\*\*)?(?:BREAKING|DEPRECATED|NEW):(?:\*\*)? /gm) || []).length;
 			const alsoChangedItems = (content.match(/\*\*Also changed:\*\*/g) || []).length;
 			if (detailedBullets > 2 && labeledBullets / (detailedBullets - alsoChangedItems || 1) < .8) warnings.push({ warning: `Only ${labeledBullets}/${detailedBullets} items have BREAKING/DEPRECATED/NEW labels` });
-			if (!/^## API Changes/m.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
+			if (!/^## API Changes/im.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
 			return warnings;
 		},
 		task: `**Find new, deprecated, and renamed APIs from version history.** Focus exclusively on APIs that changed between versions — LLMs trained on older data will use the wrong names, wrong signatures, or non-existent functions.
@@ -969,7 +244,7 @@ function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasRelea
 			const bullets = (content.match(/^- /gm) || []).length;
 			const codeBlocks = (content.match(/^```/gm) || []).length / 2;
 			if (bullets > 2 && codeBlocks / bullets > .5) warnings.push({ warning: `${Math.round(codeBlocks)}/${bullets} items have code blocks — prefer concise descriptions with source links` });
-			if (!/^## Best Practices/m.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
+			if (!/^## Best Practices/im.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
 			return warnings;
 		},
 		task: `**Extract non-obvious best practices from the references.** Focus on recommended patterns the LLM wouldn't already know: idiomatic usage, preferred configurations, performance tips, patterns that differ from what a developer would assume. Surface new patterns from recent minor releases that may post-date training data.
@@ -1043,6 +318,25 @@ const SECTION_MERGE_ORDER = [
 	"best-practices",
 	"custom"
 ];
+/** Wrap section content with HTML comment markers for targeted re-assembly */
+function wrapSection(section, content) {
+	return `<!-- skilld:${section} -->\n${content}\n<!-- /skilld:${section} -->`;
+}
+/** Extract marker-delimited sections from existing SKILL.md */
+function extractMarkedSections(md) {
+	const sections = /* @__PURE__ */ new Map();
+	for (const section of SECTION_MERGE_ORDER) {
+		const open = `<!-- skilld:${section} -->`;
+		const close = `<!-- /skilld:${section} -->`;
+		const start = md.indexOf(open);
+		const end = md.indexOf(close);
+		if (start !== -1 && end !== -1) sections.set(section, {
+			start,
+			end: end + close.length
+		});
+	}
+	return sections;
+}
 /**
 * Group files by parent directory with counts
 * e.g. `/path/to/docs/api/ (15 .md files)`
@@ -1210,6 +504,40 @@ function buildAllSectionPrompts(opts) {
 	return result;
 }
 /**
+* Transform an agent-specific prompt into a portable prompt for any LLM.
+* - Rewrites .skilld/ paths → ./references/
+* - Strips ## Output section (file-writing instructions)
+* - Strips skilld search/validate instructions
+* - Replaces tool-specific language with generic equivalents
+* - Strips agent-specific rules
+*/
+function portabilizePrompt(prompt, section) {
+	let out = prompt;
+	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(/[^`]*\/\.skilld\//, "./references/"));
+	out = out.replace(/\(\.\/\.skilld\//g, "(./references/");
+	out = out.replace(/`\.\/\.skilld\//g, "`./references/");
+	out = out.replace(/\.skilld\//g, "./references/");
+	out = out.replace(/\n## Output\n[\s\S]*$/, "");
+	out = out.replace(/\n## Search\n[\s\S]*?(?=\n\n(?:\||## |<|\*\*))/, "");
+	out = out.replace(/^- .*`skilld search`.*$/gm, "");
+	out = out.replace(/^- .*`skilld validate`.*$/gm, "");
+	out = out.replace(/,? and `skilld search`/g, "");
+	out = out.replace(/\buse Read tool to explore\b/gi, "read the files");
+	out = out.replace(/\bRead tool\b/g, "reading files");
+	out = out.replace(/\buse Read, Glob\b/gi, "read the files in");
+	out = out.replace(/\bWrite tool\b/g, "your output");
+	out = out.replace(/\bGlob\b/g, "file search");
+	out = out.replace(/\bpass `no_ignore: true`[^.]*\./g, "");
+	out = out.replace(/^- \*\*Do NOT use Task tool or spawn subagents\.\*\*.*$/gm, "");
+	out = out.replace(/^- \*\*Do NOT re-read files\*\*.*$/gm, "");
+	out = out.trimEnd();
+	const outputFile = section ? SECTION_OUTPUT_FILES[section] : void 0;
+	out += `\n\n## Output\n\nOutput the section content as plain markdown. Do not wrap in code fences.\n`;
+	if (outputFile) out += `\nSave your output as \`${outputFile}\`, then run:\n\n\`\`\`bash\nskilld assemble\n\`\`\`\n`;
+	out = out.replace(/\n{3,}/g, "\n\n");
+	return out;
+}
+/**
 * Sanitize skill name for filesystem
 */
 function sanitizeName(name) {
@@ -1255,12 +583,12 @@ function installSkillForAgents(skillName, skillContent, options = {}) {
 	};
 }
 /**
-* Create relative symlinks from each detected agent's skills dir to the shared .skills/ dir.
-* Only targets agents whose config dir already exists in the project.
+* Create a relative symlink from the target agent's skills dir to the shared .skills/ dir.
 * Replaces existing symlinks, skips real directories (user's custom skills).
 */
-function linkSkillToAgents(skillName, sharedDir, cwd) {
-	for (const [, agent] of Object.entries(targets)) {
+function linkSkillToAgents(skillName, sharedDir, cwd, agentType) {
+	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
+	for (const [, agent] of targetAgents) {
 		const agentSkillsDir = join(cwd, agent.skillsDir);
 		if (!existsSync(join(cwd, agent.skillsDir.split("/")[0]))) continue;
 		const target = join(agentSkillsDir, skillName);
@@ -1280,8 +608,9 @@ function linkSkillToAgents(skillName, sharedDir, cwd) {
 /**
 * Remove per-agent symlinks for a skill when removing from shared dir.
 */
-function unlinkSkillFromAgents(skillName, cwd) {
-	for (const [, agent] of Object.entries(targets)) {
+function unlinkSkillFromAgents(skillName, cwd, agentType) {
+	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
+	for (const [, agent] of targetAgents) {
 		const target = join(cwd, agent.skillsDir, skillName);
 		try {
 			if (lstatSync(target).isSymbolicLink()) unlinkSync(target);
@@ -1452,6 +781,6 @@ function generateFooter(relatedSkills) {
 	if (relatedSkills.length === 0) return "";
 	return `\nRelated: ${relatedSkills.join(", ")}\n`;
 }
-export { targets as _, sanitizeName as a, SECTION_OUTPUT_FILES as c, getSectionValidator as d, maxItems as f, getAgentVersion as g, detectTargetAgent as h, linkSkillToAgents as i, buildAllSectionPrompts as l, detectInstalledAgents as m, computeSkillDirName as n, unlinkSkillFromAgents as o, maxLines as p, installSkillForAgents as r, SECTION_MERGE_ORDER as s, generateSkillMd as t, buildSectionPrompt as u };
+export { sanitizeName as a, SECTION_OUTPUT_FILES as c, extractMarkedSections as d, getSectionValidator as f, maxLines as g, maxItems as h, linkSkillToAgents as i, buildAllSectionPrompts as l, wrapSection as m, computeSkillDirName as n, unlinkSkillFromAgents as o, portabilizePrompt as p, installSkillForAgents as r, SECTION_MERGE_ORDER as s, generateSkillMd as t, buildSectionPrompt as u };
 
 //# sourceMappingURL=prompts.mjs.map