chore: Prepare v1.3.0 release

numman-ali · claude · numman-ali · commit ee131b98d0e3 · 2025-12-14T10:37:22.000Z
- Bump version from 1.2.1 to 1.3.0 - Create CHANGELOG.md with full release history - Update README.md with new features documentation: - Local path installation - Private git repo support - Symlink development workflow - --output flag for sync command - --yes flag behavior updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.3.0] - 2025-12-14
+
+### Added
+
+- **Symlink support** - Skills can now be symlinked into the skills directory ([#3](https://github.com/numman-ali/openskills/issues/3))
+  - Enables git-based skill updates by symlinking from a cloned repo
+  - Supports local skill development workflows
+  - Broken symlinks are gracefully skipped
+
+- **Configurable output path** - New `--output` / `-o` flag for sync command ([#5](https://github.com/numman-ali/openskills/issues/5))
+  - Sync to any `.md` file (e.g., `.ruler/AGENTS.md`)
+  - Auto-creates file with heading if it doesn't exist
+  - Auto-creates nested directories if needed
+
+- **Local path installation** - Install skills from local directories ([#10](https://github.com/numman-ali/openskills/issues/10))
+  - Supports absolute paths (`/path/to/skill`)
+  - Supports relative paths (`./skill`, `../skill`)
+  - Supports tilde expansion (`~/my-skills/skill`)
+
+- **Private git repo support** - Install from private repositories ([#10](https://github.com/numman-ali/openskills/issues/10))
+  - SSH URLs (`git@github.com:org/private-skills.git`)
+  - HTTPS with authentication
+  - Uses system SSH keys automatically
+
+- **Comprehensive test suite** - 88 tests across 6 test files
+  - Unit tests for symlink detection, YAML parsing
+  - Integration tests for install, sync commands
+  - E2E tests for full CLI workflows
+
+### Changed
+
+- **`--yes` flag now skips all prompts** - Fully non-interactive mode for CI/CD ([#6](https://github.com/numman-ali/openskills/issues/6))
+  - Overwrites existing skills without prompting
+  - Shows `Overwriting: <skill-name>` message when skipping prompt
+  - All commands now work in headless environments
+
+- **CI workflow reordered** - Build step now runs before tests
+  - Ensures `dist/cli.js` exists for E2E tests
+
+### Security
+
+- **Path traversal protection** - Validates installation paths stay within target directory
+- **Symlink dereference** - `cpSync` uses `dereference: true` to safely copy symlink targets
+- **Non-greedy YAML regex** - Prevents potential ReDoS in frontmatter parsing
+
+## [1.2.1] - 2025-10-27
+
+### Fixed
+
+- README documentation cleanup - removed duplicate sections and incorrect flags
+
+## [1.2.0] - 2025-10-27
+
+### Added
+
+- `--universal` flag to install skills to `.agent/skills/` instead of `.claude/skills/`
+  - For multi-agent setups (Claude Code + Cursor/Windsurf/Aider)
+  - Avoids conflicts with Claude Code's native marketplace plugins
+
+### Changed
+
+- Project install is now the default (was global)
+- Skills install to `./.claude/skills/` by default
+
+## [1.1.0] - 2025-10-27
+
+### Added
+
+- Comprehensive single-page README with technical deep dive
+- Side-by-side comparison with Claude Code
+
+### Fixed
+
+- Location tag now correctly shows `project` or `global` based on install location
+
+## [1.0.0] - 2025-10-26
+
+### Added
+
+- Initial release
+- `openskills install <source>` - Install skills from GitHub repos
+- `openskills sync` - Generate `<available_skills>` XML for AGENTS.md
+- `openskills list` - Show installed skills
+- `openskills read <name>` - Load skill content for agents
+- `openskills manage` - Interactive skill removal
+- `openskills remove <name>` - Remove specific skill
+- Interactive TUI for all commands
+- Support for Anthropic's SKILL.md format
+- Progressive disclosure (load skills on demand)
+- Bundled resources support (references/, scripts/, assets/)
+
+[1.3.0]: https://github.com/numman-ali/openskills/compare/v1.2.1...v1.3.0
+[1.2.1]: https://github.com/numman-ali/openskills/compare/v1.2.0...v1.2.1
+[1.2.0]: https://github.com/numman-ali/openskills/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/numman-ali/openskills/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/numman-ali/openskills/releases/tag/v1.0.0
diff --git a/README.md b/README.md
@@ -22,8 +22,10 @@ OpenSkills brings **Anthropic's skills system** to all AI coding agents (Claude
 
 **For Claude Code users:**
 - Install skills from any GitHub repo, not just the marketplace
+- Install from local paths or private git repos
 - Share skills across multiple agents
 - Version control your skills in your repo
+- Symlink skills for local development
 
 **For other agents (Cursor, Windsurf, Aider):**
 - Get Claude Code's skills system universally
@@ -305,8 +307,8 @@ Skills with same name only appear once (highest priority wins).
 ## Commands
 
 ```bash
-openskills install <source> [options]  # Install from GitHub (interactive)
-openskills sync [-y]                   # Update AGENTS.md (interactive)
+openskills install <source> [options]  # Install from GitHub, local path, or private repo
+openskills sync [-y] [-o <path>]       # Update AGENTS.md (or custom output)
 openskills list                        # Show installed skills
 openskills read <name>                 # Load skill (for agents)
 openskills manage                      # Remove skills (interactive)
@@ -317,7 +319,8 @@ openskills remove <name>               # Remove specific skill
 
 - `--global` — Install globally to `~/.claude/skills` (default: project install)
 - `--universal` — Install to `.agent/skills/` instead of `.claude/skills/` (advanced)
-- `-y` — Skip interactive selection (for scripts/CI)
+- `-y, --yes` — Skip all prompts including overwrites (for scripts/CI)
+- `-o, --output <path>` — Custom output file for sync (default: `AGENTS.md`)
 
 ### Installation Modes
 
@@ -339,6 +342,46 @@ openskills install anthropics/skills --universal
 # → Installs to ./.agent/skills (for Claude Code + other agents)
 ```
 
+### Install from Local Paths
+
+```bash
+# Absolute path
+openskills install /path/to/my-skill
+
+# Relative path
+openskills install ./local-skills/my-skill
+
+# Home directory
+openskills install ~/my-skills/custom-skill
+
+# Install all skills from a directory
+openskills install ./my-skills-folder
+```
+
+### Install from Private Git Repos
+
+```bash
+# SSH (uses your SSH keys)
+openskills install git@github.com:your-org/private-skills.git
+
+# HTTPS (may prompt for credentials)
+openskills install https://github.com/your-org/private-skills.git
+```
+
+### Sync Options
+
+```bash
+# Sync to default AGENTS.md
+openskills sync
+
+# Sync to custom file (auto-creates if missing)
+openskills sync --output .ruler/AGENTS.md
+openskills sync -o custom-rules.md
+
+# Non-interactive (for CI/CD)
+openskills sync -y
+```
+
 ### Interactive by Default
 
 All commands use beautiful TUI by default:
@@ -434,6 +477,29 @@ Base directory: /path/to/.claude/skills/my-skill
 1. Push to GitHub: `your-username/my-skill`
 2. Users install with: `openskills install your-username/my-skill`
 
+### Local Development with Symlinks
+
+For active skill development, symlink your skill into the skills directory:
+
+```bash
+# Clone a skills repo you're developing
+git clone git@github.com:your-org/my-skills.git ~/dev/my-skills
+
+# Symlink into your project's skills directory
+mkdir -p .claude/skills
+ln -s ~/dev/my-skills/my-skill .claude/skills/my-skill
+
+# Now changes to ~/dev/my-skills/my-skill are immediately reflected
+openskills list  # Shows my-skill
+openskills sync  # Includes my-skill in AGENTS.md
+```
+
+This approach lets you:
+- Edit skills in your preferred location
+- Keep skills under version control
+- Test changes instantly without reinstalling
+- Share skills across multiple projects via symlinks
+
 ### Authoring Guide
 
 Use Anthropic's skill-creator for detailed guidance:
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "openskills",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Universal skills loader for AI coding agents - install and load Anthropic SKILL.md format skills in any agent",
   "type": "module",
   "main": "./dist/cli.js",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "openskills",`
`3`		`- "version": "1.2.1",`
	`3`	`+ "version": "1.3.0",`
`4`	`4`	`"description": "Universal skills loader for AI coding agents - install and load Anthropic SKILL.md format skills in any agent",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/cli.js",`