Highlights

• Improve evoskills update reporting with single-line check status messages.
• Show explicit CLI self-version check result in update output.
• Update summary now focuses on updated items only.
• Preserve skill references/ and scripts/ during update.
• Reuse in-process repository snapshot to reduce repeated downloads and improve update speed.

Quality

• Updated and expanded tests/test_update.bats.
• Version bumped to 3.1.3 in both package.json and CLI.

Features

• Protect AGENTS.md from auto-update when running evoskills on itself
• Add intelligent repo detection to skip auto-generation in evoskills project
• User customizations to AGENTS.md are now preserved

Fixes

• Sync package.json version with CLI_VERSION (3.1.2)
• Make test version assertions dynamic (not hardcoded)

Changes

• Add is_evoskills_repo() detection function in evoskills script
• Update cmd_init, cmd_install, cmd_remove, cmd_update to protect AGENTS.md
• Update README with architecture documentation
• Update tests to be version-agnostic

What's Changed

Bug Fixes

• Fix skill name validation errors — Removed _ prefix from name: fields in all 14 SKILL.md files (VS Code only allows lowercase letters, numbers, and hyphens in skill names)
• Restored _file-output-guard/SKILL.md content — File was accidentally emptied; content now fully restored
• Fixed _context-ack/SKILL.md frontmatter — Removed misplaced ````skill code fence that broke name parsing

Documentation

• Added AI integration option to README — Users can now tell their AI assistant: "Please integrate the skills from https://github.com/wxy/evoskills into this project."
• Clarified installation method — Updated docs to emphasize CLI-only install (direct file copying is unsupported and results in incomplete setup)
• Updated skill naming conventions — Explained why directory names keep _ prefix while name: fields no longer do

Technical Details

• Directory names (e.g., .agent/skills/_git-commit/) retain _ prefix for filesystem-level namespace isolation
• name: fields (e.g., name: git-commit) no longer use _ to comply with VS Code validation requirements
• Backward compatibility — CLI still uses _ prefix in directory paths; no breaking changes for existing installations

Commits Included

• 6183976 - fix(skills): remove _ prefix from name fields and restore missing content
• e54d19d - docs(readme): simplify AI integration option and clarify CLI-only install

v3.1.0 - Test Suite & Quality Improvements

This release adds a comprehensive test suite and improves error handling across the CLI.

New Features

Comprehensive Test Suite

• 49 BATS test cases covering all CLI functionality (95.6% pass rate)
• Quick verification script with 10 core tests (100% pass rate)
• Complete test documentation and helper utilities
• Easy CI/CD integration

Improved Error Handling

• Strict initialization: fails immediately if critical files cannot be downloaded
• Unconditional framework file updates (AI_CONSTITUTION.md, AI_INITIALIZATION.md)
• Safe file operations with temporary file handling

Configuration Management

• .evoskills-config.json now tracked for team alignment
• Smart copilot-instructions updates (no duplicates)

Installation

npm install -g @xingyu.wang/evoskills@3.1.0

Or update:

evoskills update

Quick Test

./tests/quick_test.sh

See CHANGELOG.md for detailed changes.

evoskills v3.0.1 - Command Fixes & Stability Release

🐛 Bug Fixes

Critical: evoskills init Command Now Works

• Fixed GitHub Raw URL Format: Corrected incorrect URL format that prevented skill downloads
  • Changed from https://github.com/user/repo/raw/main/* (invalid)
  • To https://raw.githubusercontent.com/user/repo/main/* (correct)
• Added github_raw_url() Helper: Centralized URL conversion logic for reliability
• Fixed Configuration Initialization: Skills repository now properly set in .evoskills-config.json

Init Command Improvements

• ✅ Skills now download successfully on evoskills init
• ✅ AI Constitution file downloads correctly
• ✅ AI Initialization protocol downloads properly
• ✅ AGENTS.md generation works without errors

Deprecated File Cleanup

• Replaced deprecated EXECUTION_RULES.md references with AI_INITIALIZATION.md
• Updated function create_execution_rules_if_missing() → create_initialization_if_missing()
• v3.0.0 architecture (mandatory initialization protocol) now fully implemented

User Impact

Before: evoskills init failed with "Failed to download skill" errors

❌ Failed to download skill: _evolution-core from 

After: evoskills init works flawlessly

✅ Downloaded .github/AI_CONSTITUTION.md
✅ Downloaded .github/AI_INITIALIZATION.md
ℹ️  Installing core skills...
✅ Installed skill: _evolution-core
✅ Installed skill: _skills-manager
... [all 14 skills install successfully]

Installation

# Update to latest version
npm install -g @xingyu.wang/evoskills@3.0.1

# Initialize a new project
evoskills init

What's Working Now

• ✅ evoskills init - Full project setup with all skills
• ✅ evoskills init --core-only - Install only core skills
• ✅ evoskills init --required-only - Install core + required system skills
• ✅ evoskills list - List all available skills
• ✅ evoskills install <skill> - Install specific skills
• ✅ evoskills update - Update CLI and all skills from GitHub

Breaking Changes

None - This is a maintenance release with bug fixes only.

Full Changelog: https://github.com/wxy/evoskills/blob/main/CHANGELOG.md#301---2026-03-05

evoskills v3.0.0 - Repository Alignment Release

🏢 Major Changes: Repository URL Unification

This major version release aligns the entire project with the canonical repository location https://github.com/wxy/evoskills. All references, documentation, and package metadata have been updated to reflect this official URL.

Repository & Package Updates

• ✅ Unified repository URL across all files to https://github.com/wxy/evoskills
• ✅ Updated package.json repository field to git+https://github.com/wxy/evoskills.git
• ✅ Corrected npm bin path format from ./evoskills to evoskills (npm standard)
• ✅ Updated README, CLI help, documentation with canonical repository links

Development Infrastructure Fixes

• 🔧 CLI Version Sync: Bumped CLI_VERSION to 3.0.0 in evoskills script
• 🔧 CI/CD Improvements:
  • Updated CI validation to check AI_INITIALIZATION.md (replaced deprecated EXECUTION_RULES.md)
  • Fixed npm publish files list to include AI_INITIALIZATION.md
  • Removed npm publish --dry-run from CI to prevent false failures on version conflicts
• 🔧 Config Generation: Project config version aligned to 3.0.0

Installation

npm install -g @xingyu.wang/evoskills@3.0.0

Or use npx directly:

npx @xingyu.wang/evoskills@3.0.0 init

Breaking Changes

None - this is a metadata and infrastructure release with no API changes.

What's Next

All future development will continue at https://github.com/wxy/evoskills. Users who cloned from other URLs should update their git remotes:

git remote set-url origin https://github.com/wxy/evoskills.git

Full Changelog: https://github.com/wxy/evoskills/blob/main/CHANGELOG.md#300---2026-03-05

What's Changed

• feat: Enforce mandatory 4-skill initialization protocol by @wxy in #3
• release: v2.2.0 release preparation by @wxy in #4

Full Changelog: v2.1.0...v2.2.0

What's Changed

🧭 Skill Path Messaging Simplification

• Updated _evolution-core to describe the canonical path directly as .agent/skills/<skill>/SKILL.md
• Removed wording that repeatedly referenced legacy path avoidance to reduce ambiguity

🧱 CLI Tier Model Alignment

• evoskills now explicitly supports three tiers:
  • Core (2): _evolution-core, _skills-manager
  • Required System (4): _instruction-guard, _context-ack, _file-output-guard, _execution-precheck
  • Optional (8): remaining workflow skills
• Added init --required-only (install Core + Required System)
• Updated list output to show all three tiers
• Updated remove guard to block both Core and Required System skills
• Updated AGENTS section generator to output tiered groups and richer skill descriptions

✅ Bug Fixes

• Config Version Consistency: evoskills init now writes project config version as 2.1.0
• CLI Version Sync: Bumped CLI runtime version from 2.0.0 to 2.1.0

📦 Release Info

• npm package version: 2.1.0 (@xingyu.wang/evoskills)
• Install: npm install -g @xingyu.wang/evoskills

Full Changelog: v2.0.0...v2.1.0