@shell-shock/plugin-skills 0.0.2

package/dist/components/skills-command.cjs

@@ -0,0 +1,163 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_constants = require('../helpers/constants.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _stryke_path_join = require("@stryke/path/join");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript = require("@powerlines/plugin-alloy/typescript");
+let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+
+//#region src/components/skills-command.tsx
+/**
+* The Skills command's handler wrapper for the Shell Shock project.
+*/
+function SkillsCommand({ skills }) {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TypescriptFile, {
+		get path() {
+			return (0, _stryke_path_join.joinPaths)(context.entryPath, "skills", "command.ts");
+		},
+		imports: {
+			"node:fs/promises": ["mkdir", "writeFile"],
+			"node:path": [
+				"dirname",
+				"join",
+				"resolve"
+			]
+		},
+		builtinImports: {
+			console: [
+				"bold",
+				"writeLine",
+				"body",
+				"warn"
+			],
+			prompts: ["multiselect", "isCancel"]
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`const AGENT_SKILL_DIR: Record<string, string> = ${JSON.stringify(require_constants.AGENT_SKILL_DIRS, null, 2)};`),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+					get heading() {
+						return `This command adds agent skills for the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} commands to the current repository.`;
+					},
+					get children() {
+						return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+							name: "agents",
+							children: "An array of agent names to add skills for. If not provided, the user will be prompted to select one or more agents."
+						});
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					get parameters() {
+						return [{
+							name: "agents",
+							type: `(${Object.values(require_constants.AGENT_SKILL_NAMES).map((name) => JSON.stringify(name)).join(" | ")})[]`,
+							default: "[]"
+						}];
+					},
+					get children() {
+						return [
+							(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`writeLine(bold(body("Adding ${Object.keys(skills).length} ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} skills to the repository...")));
+
+        const validAgents = [ ${Object.values(require_constants.AGENT_SKILL_NAMES).map((name) => JSON.stringify(name)).join(", ")} ];
+        let targetAgents: string[];
+
+        if (agents.includes("*")) {
+          targetAgents = validAgents;
+        } else if (agents.length > 0) {
+          const invalidAgents = agents.filter(agent => !validAgents.includes(agent));
+          if (invalidAgents.length > 0) {
+            throw new Error(
+              \`\${invalidAgents.length} invalid agent\${invalidAgents.length > 1 ? "s" : ""} \${invalidAgents.length > 1 ? "were" : "was"} provided: \${invalidAgents.join(", ")}. Please only provide agent types from the following list: \${validAgents.join(", ")}.\`
+            );
+          }
+
+          targetAgents = agents;
+        } else {
+          const selectedAgents = await multiselect({
+            message: "Select agents to install skills for",
+            required: true,
+            options: [
+              ${Object.entries(require_constants.AGENT_SKILL_NAMES).map(([agentKey, agentName]) => _alloy_js_core.code`{
+                    value: ${JSON.stringify(agentKey)},
+                    label: ${JSON.stringify(agentName)},
+                    description: ${JSON.stringify(require_constants.AGENT_SKILL_DIRS[agentKey] || ".agents/skills")}
+                  }`)}
+            ]
+          });
+          if (isCancel(selectedAgents)) {
+            writeLine(body("Skills installation was cancelled."));
+            return;
+          }
+
+          if (selectedAgents.length === 0) {
+            warn("No agents were selected, so there is nothing to install.");
+            return;
+          }
+
+          const invalidAgents = selectedAgents.filter(agent => !validAgents.includes(agent));
+          if (invalidAgents.length > 0) {
+            throw new Error(
+              \`\${invalidAgents.length} invalid agent\${invalidAgents.length > 1 ? "s" : ""} \${invalidAgents.length > 1 ? "were" : "was"} provided: \${invalidAgents.join(", ")}. Please only provide agent types from the following list: \${validAgents.join(", ")}.\`
+            );
+          }
+
+          targetAgents = selectedAgents;
+        }
+
+        const isPathSafe = (basePath: string, targetPath: string): boolean => {
+          const resolvedBase = resolve(basePath);
+          const resolvedTarget = resolve(targetPath);
+          return (
+            resolvedTarget === resolvedBase ||
+            resolvedTarget.startsWith(resolvedBase + "/")
+          );
+        };`),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+								get each() {
+									return Object.entries(skills);
+								},
+								doubleHardline: true,
+								children: ([skillName, skillContent]) => _alloy_js_core.code`for (const targetBase of Array.from(new Set(targetAgents.map(agent => join(process.cwd(), AGENT_SKILL_DIRS[agent] || ".agents/skills"))))) {
+              const skillDir = join(targetBase, "${skillName.toLowerCase().replace(/\s+/g, "-").replace(/[/\\:\0]/g, "").replace(/^-+|-+$/g, "")}");
+              const skillPath = join(skillDir, "SKILL.md");
+
+              if (
+                "${skillName.toLowerCase().replace(/\s+/g, "-").replace(/[/\\:\0]/g, "").replace(/^-+|-+$/g, "")}".length > 0 &&
+                isPathSafe(targetBase, skillDir) &&
+                isPathSafe(skillDir, skillPath)
+              ) {
+
+
+              await mkdir(dirname(skillPath), { recursive: true });
+              await writeFile(skillPath, ${JSON.stringify(skillContent)}, "utf8");
+
+              writeLine(body(\`Added ${skillName} skills to \${skillPath}\`));
+              } else {
+                warn(\`Skipped adding the "${skillName}" skill due to an invalid skill name. Invalid skill names could lead to an unsafe file path. Skill names must not be empty and cannot contain characters that are not allowed in file paths, such as / \\ : \\0. The skill name will be sanitized by replacing spaces with dashes, removing leading and trailing dashes, and removing any invalid characters. If the resulting skill name is empty or if the resolved skill path is outside of the target base directory, the skill will be skipped for that agent.\`
+                );
+              }
+            } `
+							}),
+							(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+							_alloy_js_core.code`writeLine(bold(body("Done!")));`
+						];
+					}
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+exports.SkillsCommand = SkillsCommand;

package/dist/components/skills-command.d.cts

@@ -0,0 +1,13 @@
+//#region src/components/skills-command.d.ts
+interface SkillsCommandProps {
+  skills: Record<string, string>;
+}
+/**
+ * The Skills command's handler wrapper for the Shell Shock project.
+ */
+declare function SkillsCommand({
+  skills
+}: SkillsCommandProps): import("@alloy-js/core").Children;
+//#endregion
+export { SkillsCommand, SkillsCommandProps };
+//# sourceMappingURL=skills-command.d.cts.map

package/dist/components/skills-command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-command.d.cts","names":[],"sources":["../../src/components/skills-command.tsx"],"mappings":";UAgCiB,kBAAA;EACf,MAAA,EAAQ,MAAM;AAAA;;;AAAA;iBAMA,aAAA;EAAgB;AAAA,GAAU,kBAAkB,4BAAA,QAAA"}

package/dist/components/skills-command.d.mts

@@ -0,0 +1,13 @@
+//#region src/components/skills-command.d.ts
+interface SkillsCommandProps {
+  skills: Record<string, string>;
+}
+/**
+ * The Skills command's handler wrapper for the Shell Shock project.
+ */
+declare function SkillsCommand({
+  skills
+}: SkillsCommandProps): import("@alloy-js/core").Children;
+//#endregion
+export { SkillsCommand, SkillsCommandProps };
+//# sourceMappingURL=skills-command.d.mts.map

package/dist/components/skills-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-command.d.mts","names":[],"sources":["../../src/components/skills-command.tsx"],"mappings":""}

package/dist/components/skills-command.mjs

@@ -0,0 +1,163 @@
+import { AGENT_SKILL_DIRS, AGENT_SKILL_NAMES } from "../helpers/constants.mjs";
+import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path/join";
+import { For, code } from "@alloy-js/core";
+import { FunctionDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { TypescriptFile } from "@powerlines/plugin-alloy/typescript";
+import { TSDoc, TSDocParam } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+
+//#region src/components/skills-command.tsx
+/**
+* The Skills command's handler wrapper for the Shell Shock project.
+*/
+function SkillsCommand({ skills }) {
+	const context = usePowerlines();
+	return createComponent(TypescriptFile, {
+		get path() {
+			return joinPaths(context.entryPath, "skills", "command.ts");
+		},
+		imports: {
+			"node:fs/promises": ["mkdir", "writeFile"],
+			"node:path": [
+				"dirname",
+				"join",
+				"resolve"
+			]
+		},
+		builtinImports: {
+			console: [
+				"bold",
+				"writeLine",
+				"body",
+				"warn"
+			],
+			prompts: ["multiselect", "isCancel"]
+		},
+		get children() {
+			return [
+				memo(() => code`const AGENT_SKILL_DIR: Record<string, string> = ${JSON.stringify(AGENT_SKILL_DIRS, null, 2)};`),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					get heading() {
+						return `This command adds agent skills for the ${getAppTitle(context)} commands to the current repository.`;
+					},
+					get children() {
+						return createComponent(TSDocParam, {
+							name: "agents",
+							children: "An array of agent names to add skills for. If not provided, the user will be prompted to select one or more agents."
+						});
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					get parameters() {
+						return [{
+							name: "agents",
+							type: `(${Object.values(AGENT_SKILL_NAMES).map((name) => JSON.stringify(name)).join(" | ")})[]`,
+							default: "[]"
+						}];
+					},
+					get children() {
+						return [
+							memo(() => code`writeLine(bold(body("Adding ${Object.keys(skills).length} ${getAppTitle(context)} skills to the repository...")));
+
+        const validAgents = [ ${Object.values(AGENT_SKILL_NAMES).map((name) => JSON.stringify(name)).join(", ")} ];
+        let targetAgents: string[];
+
+        if (agents.includes("*")) {
+          targetAgents = validAgents;
+        } else if (agents.length > 0) {
+          const invalidAgents = agents.filter(agent => !validAgents.includes(agent));
+          if (invalidAgents.length > 0) {
+            throw new Error(
+              \`\${invalidAgents.length} invalid agent\${invalidAgents.length > 1 ? "s" : ""} \${invalidAgents.length > 1 ? "were" : "was"} provided: \${invalidAgents.join(", ")}. Please only provide agent types from the following list: \${validAgents.join(", ")}.\`
+            );
+          }
+
+          targetAgents = agents;
+        } else {
+          const selectedAgents = await multiselect({
+            message: "Select agents to install skills for",
+            required: true,
+            options: [
+              ${Object.entries(AGENT_SKILL_NAMES).map(([agentKey, agentName]) => code`{
+                    value: ${JSON.stringify(agentKey)},
+                    label: ${JSON.stringify(agentName)},
+                    description: ${JSON.stringify(AGENT_SKILL_DIRS[agentKey] || ".agents/skills")}
+                  }`)}
+            ]
+          });
+          if (isCancel(selectedAgents)) {
+            writeLine(body("Skills installation was cancelled."));
+            return;
+          }
+
+          if (selectedAgents.length === 0) {
+            warn("No agents were selected, so there is nothing to install.");
+            return;
+          }
+
+          const invalidAgents = selectedAgents.filter(agent => !validAgents.includes(agent));
+          if (invalidAgents.length > 0) {
+            throw new Error(
+              \`\${invalidAgents.length} invalid agent\${invalidAgents.length > 1 ? "s" : ""} \${invalidAgents.length > 1 ? "were" : "was"} provided: \${invalidAgents.join(", ")}. Please only provide agent types from the following list: \${validAgents.join(", ")}.\`
+            );
+          }
+
+          targetAgents = selectedAgents;
+        }
+
+        const isPathSafe = (basePath: string, targetPath: string): boolean => {
+          const resolvedBase = resolve(basePath);
+          const resolvedTarget = resolve(targetPath);
+          return (
+            resolvedTarget === resolvedBase ||
+            resolvedTarget.startsWith(resolvedBase + "/")
+          );
+        };`),
+							createComponent(Spacing, {}),
+							createComponent(For, {
+								get each() {
+									return Object.entries(skills);
+								},
+								doubleHardline: true,
+								children: ([skillName, skillContent]) => code`for (const targetBase of Array.from(new Set(targetAgents.map(agent => join(process.cwd(), AGENT_SKILL_DIRS[agent] || ".agents/skills"))))) {
+              const skillDir = join(targetBase, "${skillName.toLowerCase().replace(/\s+/g, "-").replace(/[/\\:\0]/g, "").replace(/^-+|-+$/g, "")}");
+              const skillPath = join(skillDir, "SKILL.md");
+
+              if (
+                "${skillName.toLowerCase().replace(/\s+/g, "-").replace(/[/\\:\0]/g, "").replace(/^-+|-+$/g, "")}".length > 0 &&
+                isPathSafe(targetBase, skillDir) &&
+                isPathSafe(skillDir, skillPath)
+              ) {
+
+
+              await mkdir(dirname(skillPath), { recursive: true });
+              await writeFile(skillPath, ${JSON.stringify(skillContent)}, "utf8");
+
+              writeLine(body(\`Added ${skillName} skills to \${skillPath}\`));
+              } else {
+                warn(\`Skipped adding the "${skillName}" skill due to an invalid skill name. Invalid skill names could lead to an unsafe file path. Skill names must not be empty and cannot contain characters that are not allowed in file paths, such as / \\ : \\0. The skill name will be sanitized by replacing spaces with dashes, removing leading and trailing dashes, and removing any invalid characters. If the resulting skill name is empty or if the resolved skill path is outside of the target base directory, the skill will be skipped for that agent.\`
+                );
+              }
+            } `
+							}),
+							createComponent(Spacing, {}),
+							code`writeLine(bold(body("Done!")));`
+						];
+					}
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+export { SkillsCommand };
+//# sourceMappingURL=skills-command.mjs.map

package/dist/components/skills-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-command.mjs","names":[],"sources":[],"mappings":""}

package/dist/helpers/constants.cjs

@@ -0,0 +1,60 @@
+
+//#region src/helpers/constants.ts
+const AGENT_SKILL_DIRS = {
+	universal: ".agents/skills",
+	"claude-code": ".claude/skills",
+	opencode: ".agents/skills",
+	codex: ".agents/skills",
+	cursor: ".agents/skills",
+	"github-copilot": ".agents/skills",
+	warp: ".agents/skills",
+	cline: ".agents/skills",
+	continue: ".continue/skills",
+	"command-code": ".commandcode/skills",
+	"gemini-cli": ".agents/skills",
+	openhands: ".openhands/skills",
+	roo: ".roo/skills",
+	windsurf: ".windsurf/skills",
+	zencoder: ".zencoder/skills",
+	augment: ".augment/skills",
+	openclaw: "skills",
+	codebuddy: ".codebuddy/skills",
+	"codearts-agent": ".codeartsdoer/skills",
+	codemaker: ".codemaker/skills",
+	codestudio: ".codestudio/skills",
+	crush: ".crush/skills",
+	pi: ".pi/skills",
+	"tabnine-cli": ".tabnine/agent/skills",
+	replit: ".agents/skills"
+};
+const AGENT_SKILL_NAMES = {
+	universal: "Universal",
+	"claude-code": "Claude Code",
+	opencode: "OpenCode",
+	codex: "Codex",
+	cursor: "Cursor",
+	"github-copilot": "GitHub Copilot",
+	warp: "Warp",
+	cline: "Cline",
+	continue: "Continue",
+	"command-code": "Command Code",
+	"gemini-cli": "Gemini CLI",
+	openhands: "OpenHands",
+	roo: "Roo",
+	windsurf: "Windsurf",
+	zencoder: "Zencoder",
+	augment: "Augment",
+	openclaw: "OpenClaw",
+	codebuddy: "CodeBuddy",
+	"codearts-agent": "CodeArts Agent",
+	codemaker: "CodeMaker",
+	codestudio: "CodeStudio",
+	crush: "Crush",
+	pi: "Pi",
+	"tabnine-cli": "TabNine CLI",
+	replit: "Replit"
+};
+
+//#endregion
+exports.AGENT_SKILL_DIRS = AGENT_SKILL_DIRS;
+exports.AGENT_SKILL_NAMES = AGENT_SKILL_NAMES;

package/dist/helpers/constants.mjs

@@ -0,0 +1,59 @@
+//#region src/helpers/constants.ts
+const AGENT_SKILL_DIRS = {
+	universal: ".agents/skills",
+	"claude-code": ".claude/skills",
+	opencode: ".agents/skills",
+	codex: ".agents/skills",
+	cursor: ".agents/skills",
+	"github-copilot": ".agents/skills",
+	warp: ".agents/skills",
+	cline: ".agents/skills",
+	continue: ".continue/skills",
+	"command-code": ".commandcode/skills",
+	"gemini-cli": ".agents/skills",
+	openhands: ".openhands/skills",
+	roo: ".roo/skills",
+	windsurf: ".windsurf/skills",
+	zencoder: ".zencoder/skills",
+	augment: ".augment/skills",
+	openclaw: "skills",
+	codebuddy: ".codebuddy/skills",
+	"codearts-agent": ".codeartsdoer/skills",
+	codemaker: ".codemaker/skills",
+	codestudio: ".codestudio/skills",
+	crush: ".crush/skills",
+	pi: ".pi/skills",
+	"tabnine-cli": ".tabnine/agent/skills",
+	replit: ".agents/skills"
+};
+const AGENT_SKILL_NAMES = {
+	universal: "Universal",
+	"claude-code": "Claude Code",
+	opencode: "OpenCode",
+	codex: "Codex",
+	cursor: "Cursor",
+	"github-copilot": "GitHub Copilot",
+	warp: "Warp",
+	cline: "Cline",
+	continue: "Continue",
+	"command-code": "Command Code",
+	"gemini-cli": "Gemini CLI",
+	openhands: "OpenHands",
+	roo: "Roo",
+	windsurf: "Windsurf",
+	zencoder: "Zencoder",
+	augment: "Augment",
+	openclaw: "OpenClaw",
+	codebuddy: "CodeBuddy",
+	"codearts-agent": "CodeArts Agent",
+	codemaker: "CodeMaker",
+	codestudio: "CodeStudio",
+	crush: "Crush",
+	pi: "Pi",
+	"tabnine-cli": "TabNine CLI",
+	replit: "Replit"
+};
+
+//#endregion
+export { AGENT_SKILL_DIRS, AGENT_SKILL_NAMES };
+//# sourceMappingURL=constants.mjs.map

package/dist/helpers/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":[],"mappings":""}

package/dist/index.cjs

@@ -0,0 +1,68 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_components_skills_command = require('./components/skills-command.cjs');
+require('./components/index.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
+
+//#region src/index.tsx
+/**
+* The Skills - Shell Shock plugin to add version check functionality and skills commands to a Shell Shock application.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock/skills",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `skills` plugin.");
+			return { skills: (0, defu.default)({ command: { name: (0, _stryke_type_checks_is_set_string.isSetString)(options.command) ? options.command : "skills" } }, options) };
+		},
+		async configResolved() {
+			this.debug("Adding the CLI skills commands to the application context.");
+			if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.skills.path)) this.config.skills.path = (0, powerlines_plugin_utils.replacePathTokens)(this, this.config.skills.path);
+			if (!(0, _stryke_type_checks_is_set_string.isSetString)(this.config.skills.path) || !this.fs.existsSync(this.config.skills.path)) {
+				this.warn(`The skills directory could not be found at the resolved path: ${this.config.skills.path}. The \`${this.config.skills.command.name}\` command will not be added to the application. Please ensure that the skills directory exists at the specified path or adjust the \`skills.path\` option to point to the correct location.`);
+				return;
+			}
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === this.config.skills.command.name)) this.info("The `skills` command already exists in the commands list. If you would like the skills command to be managed by the `@shell-shock/plugin-skills` package, please remove or rename the command.");
+			else {
+				const skillFiles = await this.fs.list(this.config.skills.path);
+				if (skillFiles.length > 0) {
+					this.inputs.push({
+						id: this.config.skills.command.name,
+						path: this.config.skills.command.name,
+						segments: [this.config.skills.command.name],
+						title: "Skills",
+						icon: "🕶",
+						tags: ["Utility"],
+						description: `Display the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(this)} skills.`,
+						entry: {
+							file: (0, _stryke_path_join.joinPaths)(this.entryPath, "skills", "index.ts"),
+							input: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "skills", "command.ts") }
+						},
+						virtual: false,
+						...this.config.skills.command
+					});
+					this.debug("Rendering skills command module for the Shell Shock `skills` plugin.");
+					const skills = await Promise.all(skillFiles.map(async (skillFile) => [skillFile, await this.fs.read(skillFile)])).then((files) => {
+						return files.reduce((ret, [skillFile, file]) => {
+							if ((0, _stryke_type_checks_is_set_string.isSetString)(skillFile) && (0, _stryke_type_checks_is_set_string.isSetString)(file)) ret[skillFile.replace(/\.[^/.]+$/, "")] = file;
+							return ret;
+						}, {});
+					});
+					await (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_skills_command.SkillsCommand, { skills }));
+				} else this.warn(`The skills directory at the resolved path: ${this.config.skills.path} could not be read or is empty. The \`${this.config.skills.command.name}\` command will not be added to the application. Please ensure that the skills directory exists at the specified path and contains valid content.`);
+			}
+		}
+	};
+};
+
+//#endregion
+exports.default = plugin;
+exports.plugin = plugin;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { SkillsPluginContext, SkillsPluginOptions, SkillsPluginResolvedConfig, SkillsPluginUserConfig } from "./types/plugin.cjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+/**
+ * The Skills - Shell Shock plugin to add version check functionality and skills commands to a Shell Shock application.
+ */
+declare const plugin: <TContext extends SkillsPluginContext = SkillsPluginContext>(options?: SkillsPluginOptions) => Plugin<TContext>;
+//#endregion
+export { type SkillsPluginContext, type SkillsPluginOptions, type SkillsPluginResolvedConfig, type SkillsPluginUserConfig, plugin as default, plugin };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAiCA;cAAa,MAAA,oBACM,mBAAA,GAAsB,mBAAA,EAEvC,OAAA,GAAS,mBAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { SkillsPluginContext, SkillsPluginOptions, SkillsPluginResolvedConfig, SkillsPluginUserConfig } from "./types/plugin.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/index.d.ts
+/**
+ * The Skills - Shell Shock plugin to add version check functionality and skills commands to a Shell Shock application.
+ */
+declare const plugin: <TContext extends SkillsPluginContext = SkillsPluginContext>(options?: SkillsPluginOptions) => Plugin<TContext>;
+//#endregion
+export { type SkillsPluginContext, type SkillsPluginOptions, type SkillsPluginResolvedConfig, type SkillsPluginUserConfig, plugin as default, plugin };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":""}

package/dist/index.mjs

@@ -0,0 +1,65 @@
+import { SkillsCommand } from "./components/skills-command.mjs";
+import "./components/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { render } from "@powerlines/plugin-alloy/render";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path/join";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import defu from "defu";
+import { replacePathTokens } from "powerlines/plugin-utils";
+
+//#region src/index.tsx
+/**
+* The Skills - Shell Shock plugin to add version check functionality and skills commands to a Shell Shock application.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock/skills",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `skills` plugin.");
+			return { skills: defu({ command: { name: isSetString(options.command) ? options.command : "skills" } }, options) };
+		},
+		async configResolved() {
+			this.debug("Adding the CLI skills commands to the application context.");
+			if (isSetString(this.config.skills.path)) this.config.skills.path = replacePathTokens(this, this.config.skills.path);
+			if (!isSetString(this.config.skills.path) || !this.fs.existsSync(this.config.skills.path)) {
+				this.warn(`The skills directory could not be found at the resolved path: ${this.config.skills.path}. The \`${this.config.skills.command.name}\` command will not be added to the application. Please ensure that the skills directory exists at the specified path or adjust the \`skills.path\` option to point to the correct location.`);
+				return;
+			}
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === this.config.skills.command.name)) this.info("The `skills` command already exists in the commands list. If you would like the skills command to be managed by the `@shell-shock/plugin-skills` package, please remove or rename the command.");
+			else {
+				const skillFiles = await this.fs.list(this.config.skills.path);
+				if (skillFiles.length > 0) {
+					this.inputs.push({
+						id: this.config.skills.command.name,
+						path: this.config.skills.command.name,
+						segments: [this.config.skills.command.name],
+						title: "Skills",
+						icon: "🕶",
+						tags: ["Utility"],
+						description: `Display the ${getAppTitle(this)} skills.`,
+						entry: {
+							file: joinPaths(this.entryPath, "skills", "index.ts"),
+							input: { file: joinPaths(this.entryPath, "skills", "command.ts") }
+						},
+						virtual: false,
+						...this.config.skills.command
+					});
+					this.debug("Rendering skills command module for the Shell Shock `skills` plugin.");
+					const skills = await Promise.all(skillFiles.map(async (skillFile) => [skillFile, await this.fs.read(skillFile)])).then((files) => {
+						return files.reduce((ret, [skillFile, file]) => {
+							if (isSetString(skillFile) && isSetString(file)) ret[skillFile.replace(/\.[^/.]+$/, "")] = file;
+							return ret;
+						}, {});
+					});
+					await render(this, createComponent(SkillsCommand, { skills }));
+				} else this.warn(`The skills directory at the resolved path: ${this.config.skills.path} could not be read or is empty. The \`${this.config.skills.command.name}\` command will not be added to the application. Please ensure that the skills directory exists at the specified path and contains valid content.`);
+			}
+		}
+	};
+};
+
+//#endregion
+export { plugin as default, plugin };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":[],"mappings":""}