Repository navigation
Release v0.1.1
This is the initial development preview release of skillsman — a modern, zero-dependency Node.js CLI utility designed to structure, manage, and dynamically swap presets of portable AI Agent Skills.
Added
- Dynamic Preset State Machine: Implemented robust state tracking via
state.jsonto manageactivePresets,alwaysPresets, andneverPresetsprofiles. - Cycle-Safe Preset Resolver: Designed a Depth-First Search (DFS) preset tree expansion with a
visitedSet to gracefully resolve nested preset connections and prevent infinite loops. - Built-In Conflict Overrides: Engineered overlapping preset conflict resolution to preserve linked skills when multiple active presets share identical skill names.
- Global Blacklist Priority: Implemented flat priority blacklisting via the designated
never.mdpreset, filtering out forbidden skills at the final stage of projection. - Safe Environment Initialization: Created
skillsman initto generate standardized directory trees (~/.agents) and perform copy-and-verify physical skills migrations. - Declarative CLI: Migrated parameters parsing to the industry-standard
commanderlibrary, providing automated validation, aliases, and clean Spec help output. - Modern Test Suite: Created a fully automated, sandbox-isolated test suite leveraging Node.js Native Test Runner (
node:test+node:assert) covering BDD-style unit, integration, and CLI subprocess edge cases. - Single Source of Truth Metadata: Configured the CLI to dynamically bind the program name, version, and description directly to
package.jsonconfigurations. - CI/CD Automation: Integrated a unified, multi-OS GitHub Actions test suite and a reusable publish workflow to automatically test and deploy to the
npmregistry upon release. - Auto-Release Pipeline: Created a tag-triggered GitHub workflow and custom Node.js script to extract release notes and automatically generate a formal GitHub Release on push.
- Lifecycle Version Hook: Implemented automated versioning and changelog dating via the native
npm versionhook. - NPM Package Polish: Configured
package.jsonwith a robust files whitelist and an extensive, alphabetically-sorted set of 55 discoverability keywords covering the entire AI agent IDE ecosystem. - Clean Git Integration: Configured automatic ignoring of temporary test sandboxes in
.gitignoreto prevent workspace clutter during test execution. - Modular Documentation: Refactored the codebase documentation layout into a clean high-level
README.md, an exhaustivedocs/user_guide.md, and a targeteddocs/developer_guide.md.