@dollhousemcp/mcp-server 1.9.22 → 1.9.24

package/CHANGELOG.md

@@ -2,6 +2,86 @@
 
 ## [Unreleased]
 
+## [1.9.24] - 2025-10-27
+
+**Documentation Release**: Claude Skills Compatibility & Dependency Updates
+
+### 📖 Documentation
+- **Claude Skills Compatibility Section** (#1413)
+  - Added prominent README section highlighting 100% lossless round-trip conversion
+  - Documents bidirectional conversion between DollhouseMCP Skills and Claude Skills
+  - Includes skill-converter usage for CLI-enabled LLMs (Claude Code, Cursor, Gemini Code Assist)
+  - Complete metadata, validation, and structure preservation in both directions
+
+- **Merge Strategy Documentation**
+  - Documented squash vs. regular merge strategy in `docs/development/PR_BEST_PRACTICES.md`
+  - Feature → develop: SQUASH merge (clean history, normalizes contributor practices)
+  - Develop → main: REGULAR merge (preserves commits, prevents overwriting)
+  - Multi-contributor scaling considerations documented
+
+- **Session Notes**
+  - Committed session notes from Oct 25 and Oct 27 to development history
+  - Documents development decisions and context for project continuity
+
+### 🔄 Dependency Updates
+- `@modelcontextprotocol/sdk` 1.20.1 → 1.20.2
+- `posthog-node` 5.10.0 → 5.10.3
+- `jsdom` 27.0.0 → 27.0.1 (dev)
+- `@types/node` 24.8.1 → 24.9.1 (dev)
+- `@modelcontextprotocol/inspector` 0.17.1 → 0.17.2 (dev)
+
+### 🔧 Technical
+- Fixed README auto-sync workflow issue by updating chunk source files
+- README now generated from `docs/readme/chunks/` to prevent manual edit overwrites
+- All documentation changes preserved through auto-sync workflow
+
+---
+
+## [1.9.23] - 2025-10-26
+
+**Feature Release**: Bidirectional Skills Converter with DollhouseMCP primacy messaging
+
+### ✨ Features
+- **Bidirectional Skills Converter** (#1400, #1401)
+  - Lossless conversion between DollhouseMCP Skills and Claude Skills formats
+  - CLI commands: `dollhouse convert from-anthropic` / `to-anthropic`
+  - Automatic format detection (ZIP, directory, .md file)
+  - Metadata enrichment when importing Claude Skills
+  - Roundtrip conversion with 100% fidelity
+  - Comprehensive test suite (13/13 tests passing)
+
+- **Skills Converter Documentation** (docs commit 510ec3e7)
+  - Complete guide: `docs/guides/SKILLS_CONVERTER.md`
+  - Technical architecture details
+  - Usage examples and workflows
+  - CLI reference documentation
+
+- **DollhouseMCP Primacy Messaging** (docs commit bf1711d0)
+  - README section establishing timeline (July 2025 premiere)
+  - Superset positioning vs Claude Skills
+  - Professional, legally-reviewable framing
+
+### 🔧 Components
+- **SchemaMapper**: Bidirectional metadata transformation
+- **ContentExtractor**: Code block and documentation parsing
+- **DollhouseToAnthropicConverter**: Export to Claude Skills format
+- **AnthropicToDollhouseConverter**: Import from Claude Skills format
+- **CLI Interface**: `src/cli/convert.ts` with verbose/report modes
+
+### Technical Details
+- Converter location: `src/converters/`
+- CLI location: `src/cli/convert.ts`
+- Tests: `test/__tests__/unit/converter.test.ts`
+- Security: ZIP bomb detection, Unicode normalization, size limits
+- Performance: <1s for small skills, 5-30s for large skills
+
+### Documentation
+- Skills Converter Guide: `docs/guides/SKILLS_CONVERTER.md` (758 lines)
+- README primacy section: Establishes DollhouseMCP as original (July 2025)
+- Architecture comparison in guide (DollhouseMCP superset)
+
+---
+
 ## [1.9.22] - 2025-10-23
 
 **Hotfix Release**: Resolve jsdom test failures

package/README.github.md

@@ -70,6 +70,16 @@
 - **⚡  Hot-Swap Elements** – Change personas, skills, and templates without restarting as needed
 - **📦  Personal Portfolio** – Your library of custom AI configurations on your local computer or personal GitHub repo
 
+### Claude Skills Compatibility
+
+100% lossless round-trip conversion between DollhouseMCP Skills and Claude Skills—all metadata, validation, and structure preserved without loss in either direction.
+
+Import Claude Skills into the DollhouseMCP ecosystem for enhanced version control, deployment across hundreds of AI platforms that support MCP servers, security validation against hundreds of attack vectors, and integration with personas, templates, agents, and memories. Convert DollhouseMCP Skills to Claude Skills when you need compatibility with Claude-specific environments that cannot run DollhouseMCP.
+
+→ **[Complete Skills Converter Guide](docs/guides/SKILLS_CONVERTER.md)** – Lossless round-trip translation in both directions with CLI reference and examples
+
+→ Use the DollhouseMCP **skill-converter** skill to convert directly from chat on LLMs with command-line access like Claude Code, Cursor, Gemini Code Assist, etc.
+
 ### Use Cases
 
 <table>
@@ -873,6 +883,55 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## 🏷️ Version History
 
+### v1.9.24 - 2025-10-27
+
+**Documentation Release**: Claude Skills Compatibility & Dependency Updates
+
+#### 📖 Documentation
+- **Claude Skills Compatibility Section** (#1413)
+  - Added prominent README section highlighting 100% lossless round-trip conversion
+  - Documents bidirectional conversion between DollhouseMCP Skills and Claude Skills
+  - Includes skill-converter usage for CLI-enabled LLMs (Claude Code, Cursor, Gemini Code Assist)
+  - Complete metadata, validation, and structure preservation in both directions
+
+- **Merge Strategy Documentation**
+  - Documented squash vs. regular merge strategy in `docs/development/PR_BEST_PRACTICES.md`
+  - Feature → develop: SQUASH merge (clean history)
+  - Develop → main: REGULAR merge (preserves commits)
+
+#### 🔄 Dependency Updates
+- `@modelcontextprotocol/sdk` 1.20.1 → 1.20.2
+- `posthog-node` 5.10.0 → 5.10.3
+- `jsdom` 27.0.0 → 27.0.1 (dev)
+- `@types/node` 24.8.1 → 24.9.1 (dev)
+- `@modelcontextprotocol/inspector` 0.17.1 → 0.17.2 (dev)
+
+---
+
+### v1.9.23 - 2025-10-26
+
+**Feature Release**: Bidirectional Skills Converter
+#### ✨ Features
+- **Bidirectional Skills Converter** (#1400, #1401)
+  - Lossless conversion between DollhouseMCP Skills and Claude Skills
+  - CLI: `dollhouse convert from-anthropic` / `to-anthropic`
+  - Automatic format detection and metadata enrichment
+  - 100% fidelity roundtrip conversion
+  - Comprehensive documentation in `docs/guides/SKILLS_CONVERTER.md`
+
+- **DollhouseMCP Primacy Messaging**
+  - README section establishing timeline (July 2025 vs October 2025)
+  - Positions DollhouseMCP as superset with 6 element types
+  - Professional framing for legal review
+
+#### Technical Details
+- 13 converter tests passing
+- Security: ZIP size limits, bomb detection, Unicode normalization
+- Components: SchemaMapper, ContentExtractor, bidirectional converters
+- Performance: Sub-second for small skills, scales to large multi-MB skills
+
+---
+
 ### v1.9.21 - 2025-10-23
 
 **Patch Release**: Memory validation system activation and element formatting

package/README.md.backup

@@ -70,6 +70,16 @@
 - **⚡  Hot-Swap Elements** – Change personas, skills, and templates without restarting as needed
 - **📦  Personal Portfolio** – Your library of custom AI configurations on your local computer or personal GitHub repo
 
+### Claude Skills Compatibility
+
+100% lossless round-trip conversion between DollhouseMCP Skills and Claude Skills—all metadata, validation, and structure preserved without loss in either direction.
+
+Import Claude Skills into the DollhouseMCP ecosystem for enhanced version control, deployment across hundreds of AI platforms that support MCP servers, security validation against hundreds of attack vectors, and integration with personas, templates, agents, and memories. Convert DollhouseMCP Skills to Claude Skills when you need compatibility with Claude-specific environments that cannot run DollhouseMCP.
+
+→ **[Complete Skills Converter Guide](docs/guides/SKILLS_CONVERTER.md)** – Lossless round-trip translation in both directions with CLI reference and examples
+
+→ Use the DollhouseMCP **skill-converter** skill to convert directly from chat on LLMs with command-line access like Claude Code, Cursor, Gemini Code Assist, etc.
+
 ### Use Cases
 
 <table>
@@ -873,6 +883,55 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## 🏷️ Version History
 
+### v1.9.24 - 2025-10-27
+
+**Documentation Release**: Claude Skills Compatibility & Dependency Updates
+
+#### 📖 Documentation
+- **Claude Skills Compatibility Section** (#1413)
+  - Added prominent README section highlighting 100% lossless round-trip conversion
+  - Documents bidirectional conversion between DollhouseMCP Skills and Claude Skills
+  - Includes skill-converter usage for CLI-enabled LLMs (Claude Code, Cursor, Gemini Code Assist)
+  - Complete metadata, validation, and structure preservation in both directions
+
+- **Merge Strategy Documentation**
+  - Documented squash vs. regular merge strategy in `docs/development/PR_BEST_PRACTICES.md`
+  - Feature → develop: SQUASH merge (clean history)
+  - Develop → main: REGULAR merge (preserves commits)
+
+#### 🔄 Dependency Updates
+- `@modelcontextprotocol/sdk` 1.20.1 → 1.20.2
+- `posthog-node` 5.10.0 → 5.10.3
+- `jsdom` 27.0.0 → 27.0.1 (dev)
+- `@types/node` 24.8.1 → 24.9.1 (dev)
+- `@modelcontextprotocol/inspector` 0.17.1 → 0.17.2 (dev)
+
+---
+
+### v1.9.23 - 2025-10-26
+
+**Feature Release**: Bidirectional Skills Converter
+#### ✨ Features
+- **Bidirectional Skills Converter** (#1400, #1401)
+  - Lossless conversion between DollhouseMCP Skills and Claude Skills
+  - CLI: `dollhouse convert from-anthropic` / `to-anthropic`
+  - Automatic format detection and metadata enrichment
+  - 100% fidelity roundtrip conversion
+  - Comprehensive documentation in `docs/guides/SKILLS_CONVERTER.md`
+
+- **DollhouseMCP Primacy Messaging**
+  - README section establishing timeline (July 2025 vs October 2025)
+  - Positions DollhouseMCP as superset with 6 element types
+  - Professional framing for legal review
+
+#### Technical Details
+- 13 converter tests passing
+- Security: ZIP size limits, bomb detection, Unicode normalization
+- Components: SchemaMapper, ContentExtractor, bidirectional converters
+- Performance: Sub-second for small skills, scales to large multi-MB skills
+
+---
+
 ### v1.9.21 - 2025-10-23
 
 **Patch Release**: Memory validation system activation and element formatting

package/dist/cli/convert.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * CLI command for converting between Anthropic Skills and DollhouseMCP Skills
+ *
+ * Usage:
+ *   dollhouse convert to-anthropic <input> [options]
+ *   dollhouse convert from-anthropic <input> [options]
+ *
+ * Input formats:
+ *   to-anthropic:   DollhouseMCP skill file (.md)
+ *   from-anthropic: Anthropic skill directory or ZIP file
+ *
+ * Options:
+ *   -o, --output <dir>      Output directory
+ *                           Default for from-anthropic: ~/.dollhouse/portfolio/skills
+ *                           Default for to-anthropic: ./anthropic-skills
+ *   -v, --verbose           Show detailed conversion steps
+ *   -r, --report            Generate conversion report
+ *   --dry-run               Preview conversion without executing
+ *
+ * Examples:
+ *   # Convert downloaded ZIP file from Claude.ai
+ *   dollhouse convert from-anthropic ~/Downloads/my-skill.zip
+ *
+ *   # Convert Anthropic skill directory
+ *   dollhouse convert from-anthropic ~/Downloads/my-skill-folder
+ *
+ *   # Export DollhouseMCP skill to share
+ *   dollhouse convert to-anthropic ~/.dollhouse/portfolio/skills/my-skill.md -o ./exported
+ */
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/cli/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/cli/convert.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}