Major Improvements
🔧 Fixed Missing Location Tag
- Critical fix:
openskills syncnow outputs<location>tag matching Claude Code's format - Skills show
<location>project</location>or<location>global</location> - Ensures 100% compatibility with Claude Code's
<available_skills>XML structure
📚 Comprehensive Single-Page README
- Removed docs folder - everything now in one README
- Clear flow: What → How → Why
- Added "How It Works" section with Claude Code vs OpenSkills comparison
- Added "Why CLI Instead of MCP?" explaining design rationale
- Side-by-side comparison table showing identical implementation
- Full examples of both Claude Code and OpenSkills prompts
📖 Enhanced Documentation
- Complete Claude Code system prompt example
- Full OpenSkills AGENTS.md example
- Detailed progressive disclosure explanation
- Interactive TUI command examples
- Complete skill authoring guide with bundled resources
What's Changed
Fixed:
- Missing
<location>tag in generated XML (now matches Claude Code exactly)
Improved:
- Single comprehensive README (no more separate docs)
- Clear explanation of skills system and progressive disclosure
- Better organization and flow
Removed:
- Separate docs folder (consolidated into README)
Installation
npm i -g openskills@1.1.0