v2.0.6

v2.0.6 - Default .agents paths

Aligns OpenSkills defaults with the community-standard .agents/ directory layout for project and global installs, transclusion, and generated SKILLS.md paths.

Changes

• Default install and discovery paths now use .agents/skills and ~/.agents/skills
• Transclusion defaults now reference @.agents/SKILLS.md
• CLI help text and tests updated to match .agents defaults

Install

npm i -g openskills@2.0.6
# or
curl -fsSL https://ain3sh.com/openskills/install.sh | bash

v2.0.5

v2.0.5 - Fix plugin skill discovery (re-release)

Fixes a bug where Claude Code plugin skills were not being discovered due to stale installPath entries in ~/.claude/plugins/installed_plugins.json.

🐛 Bug Fix

• Plugin skill discovery: Skills from installed plugins now correctly appear in openskills list

  • Root cause: installPath in Claude Code's installed_plugins.json becomes stale when plugins update
  • Fix: Derive cache path from plugin key (cache/{marketplace}/{plugin}/) instead of trusting installPath
  • Added semver-aware version selection when multiple versions exist in cache

• Hooks / SessionStart:

  • install-hooks is now agent-aware for session env vars (Droid uses CLAUDE_ENV_FILE for now, with DROID_ENV_FILE left as a commented fallback)
  • Restricts the session hook to matcher: "startup" (Claude + Droid)
  • Adds a match-all SessionStart openskills sync hook (mirrors the recommended setup)
  • Fix: PATH injection now writes a fully-expanded PATH into the session env-file (some agents parse the env-file rather than shell-source it; writing ${PATH:-...} could be treated literally and break npx/MCP)

• Tests:

  • Make CLI/integration tests hermetic by isolating HOME to avoid local Claude plugin installs causing timeouts
  • Increased timeouts for a couple of integration tests under load

🧹 Code Cleanup

• Removed broken marketplace manifest fallback (~70 lines)
  • The old fallback looked in the wrong location (marketplace repo instead of cache)
• Removed unused interfaces: KnownMarketplacesFile, MarketplaceManifest
• Simplified discovery loop from 90+ lines to ~30 lines

🧪 Tests

• Updated plugin tests to use cache-based directory structure
• Added tests for semver version selection
• Added tests for semver preference over commit hashes

Install

npm i -g openskills@2.0.5
# or
curl -fsSL https://ain3sh.com/openskills/install.sh | bash

v2.0.4

v2.0.4 - Agent-first defaults + legacy cleanup

Major cleanup release that removes legacy compatibility code, aligns with the official Claude Code Skills spec, and restructures the codebase for clarity.

✨ Highlights

• Agent-first by default: All commands are now non-interactive by default
  • Use --tui for interactive mode (replaces -y/--yes)
  • sync uses transclusion by default (--direct for inline embedding)
  • sync creates AGENTS.md if missing instead of erroring
• Session hook fix: Fixed PATH corruption bug - hook now uses ${PATH:-fallback} to prevent broken shells
• Official spec alignment: SKILL.md frontmatter now strictly follows Claude Code Skills spec

🗑️ Legacy Removal

• Removed session-hook command (replaced by bash script)
• Removed skill-prompt command (use tool-description)
• Removed non-spec frontmatter fields: when_to_use, disable-model-invocation, snake_case variants

🏗️ Codebase Restructure

Source reorganized from flat src/utils/ to domain-specific directories:

• src/skill/ - Core skill logic (discovery, validation, frontmatter)
• src/agent/ - Agent platform integration (plugins, agents-md)
• src/config/ - Configuration and paths
• src/marketplace/ - GitHub integration
• src/telemetry/ - Usage tracking

Tests restructured to mirror src/ layout. All 147 tests pass.

🛠 Usage

# Non-interactive by default (agent-first)
openskills install anthropics/skills/skill-name
openskills sync

# Interactive mode with --tui
openskills install anthropics/skills --tui
openskills sync --tui

Install

npm i -g openskills@2.0.4
# or
curl -fsSL https://ain3sh.com/openskills/install.sh | bash
```tps://ain3sh.com/openskills/install.sh | bash

v2.0.3

v2.0.3 - Droid hook fix + plugin discovery (SEA binaries fixed)

This is a re-release of v2.0.3 with corrected SEA binaries (the previous binaries could crash on install-hooks).

✨ Highlights

• SEA binary fix: openskills install-hooks -g --agent droid no longer crashes (ERR_UNKNOWN_BUILTIN_MODULE / ./impl/format).
• Factory/Droid hooks now work reliably
  • install-hooks supports JSONC (// comments) in ~/.factory/settings.json and preserves comment headers when writing.
  • Installs a proper SessionStart hook + PATH bootstrap so ~/.openskills/bin aliases work inside sessions.
• Manifest-driven Claude plugin skill discovery (fast, no recursive scans)
  • Supports both skills/<name>/SKILL.md collections and single-skill directories with SKILL.md at the root.
• Agent-aware listing
  • list-skills (agent-facing) filters to enabled plugin skills when enabledPlugins is configured.
  • openskills list shows everything and marks [enabled] / [disabled] when available.

🛠 Usage

openskills install-hooks -g --agent droid
openskills list
openskills list-skills

Install

npm i -g openskills@2.0.3
# or
curl -fsSL https://ain3sh.com/openskills/install.sh | bash

v2.0.2

v2.0.2 - Agent Hooks & Aliases

This release introduces a seamless integration system for AI agents (Claude Code, Factory Droid), allowing you to install shorthand aliases like install-skill and list-skills directly into your agent's session.

✨ New Features

• Hooks System: New install-hooks command to inject SessionStart hooks into your agent configuration.
• Agent Aliases: Automatically creates wrapper scripts (install-skill, sync-skills, etc.) for easier use within agent sessions.
• Multi-Agent Support:
  • --agent claude: Targets Claude Code (default)
  • --agent droid: Targets Factory Droid
• Manual Mode: Generate configuration for manual installation with --manual.

🛠 Usage

# Install hooks for Claude Code (default)
openskills install-hooks

# Install hooks for Factory Droid
openskills install-hooks --agent droid

# Generate config for manual install
openskills install-hooks --manual

🐛 Fixes & Improvements

• Shebang Update: Updated shebang to use env for better portability across environments (945df06).
• Human-Readable List: The list command now outputs Markdown instead of JSON by default for better agent readability (6b3841c).

Install

npm i -g openskills@2.0.2
# or
curl -fsSL https://ain3sh.com/openskills/install.sh | bash

v2.0.1

📊 openskills v2.0.1

Single executable binaries for all platforms (no Node.js required!)

Installation

Manual download:

• Linux x64: openskills-linux-x64
• macOS Intel: openskills-darwin-x64
• macOS Apple Silicon: openskills-darwin-arm64
• Windows: openskills-win32-x64.exe

SHA256 checksums are provided for each binary.

For Contributors

npm install -g openskills

What's Changed

• Improve release workflow with manual dispatch and matrix builds by @ain3sh in #8

Full Changelog: v2.0.0...v2.0.1

v2.0.0

📊 openskills v2.0.0

Single executable binaries for all platforms (no Node.js required!)

Installation

Manual download:

• Linux x64: openskills-linux-x64
• macOS Intel: openskills-darwin-x64
• macOS Apple Silicon: openskills-darwin-arm64
• Windows: openskills-win32-x64.exe

SHA256 checksums are provided for each binary.

For Contributors

npm install -g openskills

What's Changed

• v2: Serverless Skill Tool CLI, SEA binaries, and one-line installer by @ain3sh in #4
• fix: remove import.meta.url usage that breaks SEA bundles by @ain3sh in #5
• fix: add GITHUB_TOKEN permissions for release asset uploads by @ain3sh in #6
• feat: move SKILLS.md to .agent/SKILLS.md for cleaner project structure by @ain3sh in #7

Full Changelog: https://github.com/ain3sh/openskills/commits/v2.0.0