skills-manifest 0.0.0

package/LICENSE.md

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

package/README.md

@@ -0,0 +1,70 @@
+# skills-manifest
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![bundle][bundle-src]][bundle-href]
+[![JSDocs][jsdocs-src]][jsdocs-href]
+[![License][license-src]][license-href]
+
+A standardized JSON schema and metadata specification for defining, versioning, and sharing professional skillsets.
+
+> [!IMPORTANT]
+> The `skills add <args>` will not automatically update the `skills-manifest.json` file.
+> Currently, [skills](https://github.com/vercel-labs/skills) does not support project-level.lock file. This project is only intended as temporary solution for sharing skills during collaborative work.
+
+## Install
+
+```bash
+pnpm add skills skills-manifest -D
+```
+
+## Config
+
+`skills-manifest.json`:
+
+```json
+{
+  "agents": ["cursor", "claude"],
+  "skills": {
+    "vercel-labs/agent-skills": {
+      "vercel-react-best-practices": true
+    },
+    "https://github.com/vercel-labs": {
+      "find-skills": true
+    }
+  }
+}
+```
+
+`.gitignore`:
+
+```
+skills
+```
+
+`package.json`:
+
+```json
+{
+  "scripts": {
+    "prepare": "skills-manifest install"
+  }
+}
+```
+
+## License
+
+[MIT](./LICENSE) License © [Hairyf](https://github.com/hairyf)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/skills-manifest?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/skills-manifest
+[npm-downloads-src]: https://img.shields.io/npm/dm/skills-manifest?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/skills-manifest
+[bundle-src]: https://img.shields.io/bundlephobia/minzip/skills-manifest?style=flat&colorA=080f12&colorB=1fa669&label=minzip
+[bundle-href]: https://bundlephobia.com/result?p=skills-manifest
+[license-src]: https://img.shields.io/github/license/antfu/skills-manifest.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/antfu/skills-manifest/blob/main/LICENSE
+[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
+[jsdocs-href]: https://www.jsdocs.io/package/skills-manifest

package/bin/index.dev.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+'use strict'
+
+import { register } from 'tsx/esm/api'
+
+// Register tsx enhancement
+const unregister = register()
+
+// eslint-disable-next-line antfu/no-top-level-await
+await import('../src/cli/index.ts')
+
+unregister()

package/bin/index.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict'
+
+import '../dist/cli/index.mjs'

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli/index.mjs

@@ -0,0 +1,45 @@
+import { loadConfig } from "c12";
+import { defineCommand, runMain } from "citty";
+import { x } from "tinyexec";
+
+//#region package.json
+var version = "0.0.0";
+
+//#endregion
+//#region src/cli/index.ts
+runMain(defineCommand({
+	meta: {
+		name: "install",
+		version,
+		description: "Install skills"
+	},
+	async run() {
+		const { config } = await loadConfig({ configFile: "skills-manifest" });
+		const repos = Object.keys(config.skills);
+		for (const repo of repos) {
+			if (typeof config.skills[repo] === "boolean") {
+				await x("skills", [
+					"add",
+					repo,
+					"--agent",
+					...config.agents,
+					"--all",
+					"--yes"
+				], { nodeOptions: { stdio: "inherit" } });
+				continue;
+			}
+			await x("skills", [
+				"add",
+				repo,
+				"--skill",
+				...Array.isArray(config.skills[repo]) ? config.skills[repo] : Object.keys(config.skills[repo]).filter((skill) => config.skills[repo][skill] === true),
+				"--agent",
+				...config.agents,
+				"--yes"
+			], { nodeOptions: { stdio: "inherit" } });
+		}
+	}
+}));
+
+//#endregion
+export {  };

package/dist/index-OGqMIJuf.d.mts

@@ -0,0 +1,13 @@
+//#region src/types/index.d.ts
+type Repo = boolean | {
+  [skill: string]: boolean;
+} | string[];
+interface Skills {
+  [repo: string]: Repo;
+}
+interface SkillsManifest {
+  skills: Skills;
+  agents: string[];
+}
+//#endregion
+export { Skills as n, SkillsManifest as r, Repo as t };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { n as Skills, r as SkillsManifest, t as Repo } from "./index-OGqMIJuf.mjs";
+export { Repo, Skills, SkillsManifest };

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import "./types/index.mjs";
+
+export {  };

package/dist/types/index.d.mts

@@ -0,0 +1,2 @@
+import { n as Skills, r as SkillsManifest, t as Repo } from "../index-OGqMIJuf.mjs";
+export { Repo, Skills, SkillsManifest };

package/dist/types/index.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "skills-manifest",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "_description_",
+  "author": "Hairyf <wwu710632@gmail.com>",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/hairyf",
+  "homepage": "https://github.com/hairyf/skills-manifest#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hairyf/skills-manifest.git"
+  },
+  "bugs": "https://github.com/hairyf/skills-manifest/issues",
+  "keywords": [],
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "bin": {
+    "skills-manifest": "./bin/index.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "peerDependencies": {
+    "skills": "^1.2.0"
+  },
+  "dependencies": {
+    "c12": "^3.3.3",
+    "citty": "^0.2.0",
+    "tinyexec": "^1.0.2"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.6.1",
+    "@antfu/ni": "^28.0.0",
+    "@antfu/utils": "^9.3.0",
+    "@types/node": "^25.0.1",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
+    "lint-staged": "^16.2.7",
+    "publint": "^0.3.16",
+    "simple-git-hooks": "^2.13.1",
+    "skills": "^1.2.0",
+    "tsdown": "^0.17.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15",
+    "vitest-package-exports": "^0.1.1",
+    "yaml": "^2.8.2",
+    "skills-manifest": "0.0.0"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "eslint",
+    "release": "bumpp",
+    "start": "tsx src/index.ts",
+    "test": "vitest",
+    "typecheck": "tsc"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts"
+}