local-skills-mcp 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,51 @@
1
1
  # Changelog
2
2
 
3
+ All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
4
+
5
+ ## <small>0.2.2 (2025-11-10)</small>
6
+
7
+ - fix: trigger 0.2.2 release ([cce30a5](https://github.com/kdpa-llc/local-skills-mcp/commit/cce30a5))
8
+ - chore: bump version to 0.2.2 ([1e26933](https://github.com/kdpa-llc/local-skills-mcp/commit/1e26933))
9
+
10
+ ## <small>0.2.1 (2025-11-09)</small>
11
+
12
+ - fix: resolve symlink issue in entry point detection for npm global installs (#49) ([629ea38](https://github.com/kdpa-llc/local-skills-mcp/commit/629ea38)), closes [#49](https://github.com/kdpa-llc/local-skills-mcp/issues/49) [#48](https://github.com/kdpa-llc/local-skills-mcp/issues/48)
13
+
14
+ ## 0.2.0 (2025-11-08)
15
+
16
+ - feat: add code quality tools (ESLint, Prettier, Husky) (#16) ([870a240](https://github.com/kdpa-llc/local-skills-mcp/commit/870a240)), closes [#16](https://github.com/kdpa-llc/local-skills-mcp/issues/16) [#16](https://github.com/kdpa-llc/local-skills-mcp/issues/16)
17
+ - feat: add GitHub Actions CI/CD workflows (#15) ([bc95dbf](https://github.com/kdpa-llc/local-skills-mcp/commit/bc95dbf)), closes [#15](https://github.com/kdpa-llc/local-skills-mcp/issues/15) [#15](https://github.com/kdpa-llc/local-skills-mcp/issues/15)
18
+ - feat: configure Dependabot for automated dependency management (#18) ([44a4eb0](https://github.com/kdpa-llc/local-skills-mcp/commit/44a4eb0)), closes [#18](https://github.com/kdpa-llc/local-skills-mcp/issues/18) [#18](https://github.com/kdpa-llc/local-skills-mcp/issues/18)
19
+ - feat: implement semantic-release for automated versioning (#19) ([af79614](https://github.com/kdpa-llc/local-skills-mcp/commit/af79614)), closes [#19](https://github.com/kdpa-llc/local-skills-mcp/issues/19) [#19](https://github.com/kdpa-llc/local-skills-mcp/issues/19)
20
+ - feat: Include package built-in skills as default base (#7) ([b18f61f](https://github.com/kdpa-llc/local-skills-mcp/commit/b18f61f)), closes [#7](https://github.com/kdpa-llc/local-skills-mcp/issues/7) [#7](https://github.com/kdpa-llc/local-skills-mcp/issues/7)
21
+ - feat: npm publishing with OIDC trusted publishers and initial v0.1.0 release (#46) ([b660431](https://github.com/kdpa-llc/local-skills-mcp/commit/b660431)), closes [#46](https://github.com/kdpa-llc/local-skills-mcp/issues/46)
22
+ - Add comprehensive API documentation (#23) ([6434598](https://github.com/kdpa-llc/local-skills-mcp/commit/6434598)), closes [#23](https://github.com/kdpa-llc/local-skills-mcp/issues/23) [Hi#level](https://github.com/Hi/issues/level) [#23](https://github.com/kdpa-llc/local-skills-mcp/issues/23)
23
+ - Add comprehensive test suite achieving 95%+ coverage with unit, integration, and E2E tests (#29) ([5971d31](https://github.com/kdpa-llc/local-skills-mcp/commit/5971d31)), closes [#29](https://github.com/kdpa-llc/local-skills-mcp/issues/29)
24
+ - Add GitHub Sponsors funding option ([d86f368](https://github.com/kdpa-llc/local-skills-mcp/commit/d86f368))
25
+ - Add project documentation for Claude Code ([4c5683d](https://github.com/kdpa-llc/local-skills-mcp/commit/4c5683d))
26
+ - Add repository-specific example skills and comprehensive usage guide ([e3ca56d](https://github.com/kdpa-llc/local-skills-mcp/commit/e3ca56d)), closes [hi#quality](https://github.com/hi/issues/quality)
27
+ - Claude/enable full hot reload 011 c us6 eneh bty xhds km xyqv (#45) ([0cc9740](https://github.com/kdpa-llc/local-skills-mcp/commit/0cc9740)), closes [#45](https://github.com/kdpa-llc/local-skills-mcp/issues/45)
28
+ - Configure branch protection and repository settings (#21) ([d9919bc](https://github.com/kdpa-llc/local-skills-mcp/commit/d9919bc)), closes [#21](https://github.com/kdpa-llc/local-skills-mcp/issues/21) [#21](https://github.com/kdpa-llc/local-skills-mcp/issues/21)
29
+ - Enhance contributor experience with automation (#22) ([b3ac1ad](https://github.com/kdpa-llc/local-skills-mcp/commit/b3ac1ad)), closes [#22](https://github.com/kdpa-llc/local-skills-mcp/issues/22) [#22](https://github.com/kdpa-llc/local-skills-mcp/issues/22)
30
+ - Enhance README with badges, ToC, demo section, and comprehensive FAQ ([3986194](https://github.com/kdpa-llc/local-skills-mcp/commit/3986194))
31
+ - Fix repository references and optimize npm packaging ([3944ca4](https://github.com/kdpa-llc/local-skills-mcp/commit/3944ca4))
32
+ - Fix version numbers in SECURITY.md ([06a14e3](https://github.com/kdpa-llc/local-skills-mcp/commit/06a14e3))
33
+ - Streamline and fix README documentation ([43cce88](https://github.com/kdpa-llc/local-skills-mcp/commit/43cce88))
34
+ - Streamline and refine README (#4) ([cb04ece](https://github.com/kdpa-llc/local-skills-mcp/commit/cb04ece)), closes [#4](https://github.com/kdpa-llc/local-skills-mcp/issues/4)
35
+ - Update repository URLs from moscaverd to kdpa-llc organization ([da739be](https://github.com/kdpa-llc/local-skills-mcp/commit/da739be))
36
+ - fix: resolve linting errors and sync fork with upstream (#41) ([dc6965c](https://github.com/kdpa-llc/local-skills-mcp/commit/dc6965c)), closes [#41](https://github.com/kdpa-llc/local-skills-mcp/issues/41)
37
+ - fix: resolve test file handle leaks and improve cross-platform compatibility ([ccc2408](https://github.com/kdpa-llc/local-skills-mcp/commit/ccc2408))
38
+ - ci(deps): bump actions/checkout from 4 to 5 ([a0fa14f](https://github.com/kdpa-llc/local-skills-mcp/commit/a0fa14f))
39
+ - ci(deps): bump actions/setup-node from 4 to 6 ([75eac33](https://github.com/kdpa-llc/local-skills-mcp/commit/75eac33))
40
+ - ci(deps): bump codecov/codecov-action from 4 to 5 ([d8a95e3](https://github.com/kdpa-llc/local-skills-mcp/commit/d8a95e3))
41
+ - ci(deps): bump github/codeql-action from 3 to 4 ([2b2820e](https://github.com/kdpa-llc/local-skills-mcp/commit/2b2820e))
42
+ - chore: exclude CLAUDE.md from git and npm, add .tmp/ for temporary files ([7c2f06d](https://github.com/kdpa-llc/local-skills-mcp/commit/7c2f06d))
43
+ - chore(deps-dev): bump @types/node from 22.18.13 to 24.10.0 ([af8bc4f](https://github.com/kdpa-llc/local-skills-mcp/commit/af8bc4f))
44
+ - chore(deps-dev): bump the development-dependencies group with 2 updates (#37) ([6ce77d2](https://github.com/kdpa-llc/local-skills-mcp/commit/6ce77d2)), closes [#37](https://github.com/kdpa-llc/local-skills-mcp/issues/37)
45
+ - docs: replace hardcoded values with dynamic references (#20) ([45a8d80](https://github.com/kdpa-llc/local-skills-mcp/commit/45a8d80)), closes [#20](https://github.com/kdpa-llc/local-skills-mcp/issues/20) [#20](https://github.com/kdpa-llc/local-skills-mcp/issues/20)
46
+
47
+ # Changelog
48
+
3
49
  All notable changes to this project will be documented in this file.
4
50
 
5
51
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
@@ -8,11 +54,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
8
54
  ## [Unreleased]
9
55
 
10
56
  ### Added
57
+
11
58
  - Package built-in skills directory as base default for all MCP instances
12
59
  - Self-documenting capabilities: `local-skills-mcp-usage`, `local-skills-mcp-guide`, and `skill-creator` skills
13
60
  - Skills are now available immediately after installation with zero configuration
14
61
 
15
62
  ### Changed
63
+
16
64
  - Directory aggregation priority updated to include package built-in skills as lowest priority (first in list)
17
65
  - Updated documentation to reflect new built-in skills feature
18
66
 
@@ -25,16 +73,19 @@ This is the initial public release of Local Skills MCP - a proof of concept for
25
73
  ### Features
26
74
 
27
75
  #### Universal LLM/Agent Support
76
+
28
77
  - Works with any MCP-compatible client (Claude Code, Claude Desktop, Cline, Continue.dev, custom agents)
29
78
  - Portable skills that work across multiple AI systems
30
79
  - LLM-agnostic design (Claude, GPT, Gemini, local models, etc.)
31
80
 
32
81
  #### Efficient Context Management
82
+
33
83
  - Lazy loading: only skill names and descriptions initially visible (~50 tokens per skill)
34
84
  - Full content loads on-demand, preserving 95%+ of context window
35
85
  - Progressive disclosure pattern optimized for context efficiency
36
86
 
37
87
  #### Powerful Skill Management
88
+
38
89
  - Standard SKILL.md format with YAML frontmatter
39
90
  - Automatic aggregation from multiple directories (~/.claude/skills, ./.claude/skills, ./skills, custom)
40
91
  - Dynamic discovery: tool description updates in real-time with available skills
@@ -42,6 +93,7 @@ This is the initial public release of Local Skills MCP - a proof of concept for
42
93
  - Ultra-simple API: single `get_skill` tool with built-in discovery
43
94
 
44
95
  #### Open Source Best Practices
96
+
45
97
  - Comprehensive contribution guidelines (CONTRIBUTING.md)
46
98
  - Code of Conduct (Contributor Covenant v2.0)
47
99
  - Security policy and vulnerability reporting (SECURITY.md)
@@ -50,6 +102,7 @@ This is the initial public release of Local Skills MCP - a proof of concept for
50
102
  - MIT License
51
103
 
52
104
  ### Technical Implementation
105
+
53
106
  - TypeScript with Node.js 18+
54
107
  - Model Context Protocol SDK integration
55
108
  - Version centralized in package.json (single source of truth)
@@ -63,31 +116,37 @@ This is the initial public release of Local Skills MCP - a proof of concept for
63
116
  The following versions were internal development iterations before the public release:
64
117
 
65
118
  ### [Internal 2.2.0] - 2025-11-01
119
+
66
120
  - Simplified to single tool (removed list_skills)
67
121
  - Generic, utilization-focused tool descriptions
68
122
  - Dynamic skill list in get_skill description
69
123
 
70
124
  ### [Internal 2.1.0] - 2025-11-01
125
+
71
126
  - Enhanced tool descriptions following Claude Skills best practices
72
127
  - Added comprehensive documentation on skill description patterns
73
128
  - Improved trigger keyword matching
74
129
 
75
130
  ### [Internal 2.0.0] - 2025-10-30
131
+
76
132
  - Changed to official Claude Skills format (SKILL.md)
77
133
  - Added multi-directory skill aggregation
78
134
  - Removed custom skill.json format
79
135
 
80
136
  ### [Internal 1.0.0] - 2025-10-29
137
+
81
138
  - Initial prototype with custom format
82
139
  - Four MCP tools with parameter interpolation
83
140
 
84
141
  ---
85
142
 
86
143
  <!-- Version Links -->
144
+
87
145
  [0.1.0]: https://github.com/kdpa-llc/local-skills-mcp/releases/tag/v0.1.0
88
146
  [unreleased]: https://github.com/kdpa-llc/local-skills-mcp/compare/v0.1.0...HEAD
89
147
 
90
148
  <!-- Reference Links -->
149
+
91
150
  [repo]: https://github.com/kdpa-llc/local-skills-mcp
92
151
  [issues]: https://github.com/kdpa-llc/local-skills-mcp/issues
93
152
  [pulls]: https://github.com/kdpa-llc/local-skills-mcp/pulls
package/dist/index.js CHANGED
@@ -254,7 +254,8 @@ export class LocalSkillsServer {
254
254
  }
255
255
  // Start the server only if this module is being run directly
256
256
  /* istanbul ignore if */
257
- if (import.meta.url === `file://${process.argv[1]}`) {
257
+ if (import.meta.url === `file://${process.argv[1]}` ||
258
+ (process.argv[1] && __filename === fs.realpathSync(process.argv[1]))) {
258
259
  const server = new LocalSkillsServer();
259
260
  server.run().catch((error) => {
260
261
  console.error("Fatal error running server:", error);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "local-skills-mcp",
3
- "version": "0.2.1",
3
+ "version": "0.2.2",
4
4
  "description": "Universal MCP server enabling any LLM or AI agent to utilize expert skills from your local filesystem. Reduces context consumption through lazy loading - only skill names visible initially, full content loads on-demand. Works with Claude, Cline, custom agents, and any MCP-compatible client.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",