@lyupro/skillforge-mcp 1.1.0

package/manifest.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://modelcontextprotocol.io/schemas/manifest.json",
+  "name": "@lyupro/skillforge-mcp",
+  "displayName": "SkillForge MCP",
+  "version": "1.1.0",
+  "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool (Claude Code / Codex CLI / any MCP client).",
+  "author": {
+    "name": "lyupro",
+    "url": "https://lyupro.com"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/lyupro/skillforge-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lyupro/skillforge-mcp.git"
+  },
+  "bugs": "https://github.com/lyupro/skillforge-mcp/issues",
+  "keywords": [
+    "mcp",
+    "skills",
+    "claude-code",
+    "codex",
+    "cursor",
+    "model-context-protocol",
+    "ai-agents",
+    "prompt-engineering",
+    "lazy-loading",
+    "cross-tool"
+  ],
+  "categories": ["productivity", "developer-tools", "ai-agents"],
+  "runtime": {
+    "type": "node",
+    "engines": {
+      "node": ">=20.0.0"
+    },
+    "entry": "./dist/server.js",
+    "bin": "skillforge-mcp"
+  },
+  "transport": "stdio",
+  "tools": [
+    {
+      "name": "skills__list",
+      "description": "Enumerate available skills (metadata only). Filters: folder, search, source."
+    },
+    {
+      "name": "skills__get",
+      "description": "Retrieve the full content (body + metadata) of a named skill."
+    },
+    {
+      "name": "skills__invoke",
+      "description": "Invoke a skill by name, forwarding optional input. Composite skills (metadata.skills) walk nested skills sequentially with DFS cycle detection. Pipeline: Logging → Timeout → Cache → strategy (Prompt / Script / Hybrid)."
+    },
+    {
+      "name": "skills__configure",
+      "description": "Manage configured skill folders, blacklist, and reset to defaults. Actions: add_folder, remove_folder, list_folders, set_blacklist, get_blacklist, reset. Persists to the platform config path."
+    },
+    {
+      "name": "skills__reload",
+      "description": "Force a full rescan of all configured folders. Returns { loaded, added, removed, errors } diff against the previous registry snapshot."
+    }
+  ],
+  "environment": {
+    "SKILLFORGE_FOLDERS": {
+      "description": "Override folder list (path-separator: ':' POSIX, ';' Windows). When set, overrides persisted folders[] entirely.",
+      "required": false
+    },
+    "SKILLFORGE_TTL_MS": {
+      "description": "Metadata cache TTL in ms. Default 300000 (5 min).",
+      "required": false
+    }
+  },
+  "documentation": {
+    "readme": "./README.md",
+    "install": "./docs/INSTALL.md",
+    "skillFormat": "./docs/SKILL_FORMAT.md",
+    "configuration": "./docs/CONFIGURATION.md",
+    "architecture": "./docs/ARCHITECTURE.md",
+    "security": "./docs/SECURITY.md",
+    "integration": {
+      "claudeCode": "./docs/INTEGRATION/claude-code.md",
+      "codex": "./docs/INTEGRATION/codex.md",
+      "cursor": "./docs/INTEGRATION/cursor.md",
+      "customLlmTools": "./docs/INTEGRATION/custom-llm-tools.md"
+    }
+  },
+  "samples": {
+    "skills": "./skills",
+    "configs": "./examples/configs"
+  },
+  "verification": {
+    "smokeTest": "pnpm smoke",
+    "testCommand": "pnpm test",
+    "lintCommand": "pnpm lint",
+    "sizeGate": "pnpm check:size"
+  }
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@lyupro/skillforge-mcp",
+  "version": "1.1.0",
+  "description": "Universal Skills MCP Server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool (Claude Code / Codex CLI / any MCP client).",
+  "keywords": [
+    "mcp",
+    "skills",
+    "claude-code",
+    "codex",
+    "model-context-protocol",
+    "ai-agents",
+    "prompt-engineering"
+  ],
+  "license": "MIT",
+  "author": "lyupro (https://lyupro.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lyupro/skillforge-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lyupro/skillforge-mcp/issues"
+  },
+  "homepage": "https://github.com/lyupro/skillforge-mcp#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "bin": {
+    "skillforge-mcp": "./dist/server.js",
+    "skillforge": "./dist/cli/install.js"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx watch src/server.ts",
+    "start": "node dist/server.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "check:size": "node scripts/check-file-size.mjs",
+    "smoke": "node scripts/smoke-test.mjs",
+    "prepare": "simple-git-hooks",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chokidar": "^3.6.0",
+    "gray-matter": "^4.0.3",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/iarna__toml": "^2.0.5",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "glob": "^11.0.0",
+    "simple-git-hooks": "^2.11.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "node scripts/check-file-size.mjs --error"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.33.2+sha512.a90faf6feeab71ad6c6e57f94e0fe1a12f5dcc22cd754db40ae9593eb6a3e0b6b12e3540218bb37ae083404b1f2ce6db2a4121e979829b4aff94b99f49da1cf8"
+}