Skip to content

feat: add Rooms-native Skillware CLI and wizard assignment#61

Merged
rosspeili merged 1 commit into
ARPAHLS:mainfrom
rosspeili:feat/issue-57-skillware-cli-wrapper
Jun 17, 2026
Merged

feat: add Rooms-native Skillware CLI and wizard assignment#61
rosspeili merged 1 commit into
ARPAHLS:mainfrom
rosspeili:feat/issue-57-skillware-cli-wrapper

Conversation

@rosspeili

Copy link
Copy Markdown
Contributor

Introduce optional skills list/inspect/suggest commands and custom-agent wizard skill assignment with graceful no-Skillware handling, plus tests and docs updates for the integrated skill-aware UX.


Summary

  • Adds Rooms-native Skillware CLI commands for discovery and inspection:
    • python cli.py skills list
    • python cli.py skills inspect <skill_id>
    • python cli.py skills suggest --expertise a,b,c
  • Extends the custom-agent wizard with optional skill assignment and per-skill runtime overrides.
  • Preserves graceful behavior when Skillware is not installed (clear guidance, no core workflow break).
  • Aligns docs with current product state and adds a dedicated Skillware guide.

Why

Rooms already supports per-agent runtime skill execution and structured session logging.
This PR completes the operator UX layer so users can discover, inspect, and assign skills directly from Rooms CLI without leaving the project’s native interface.

What Changed

CLI and Wizard

  • Added skills subcommands in cli.py:
    • list
    • inspect
    • suggest
  • Added custom-agent wizard step to:
    • optionally assign one or more skill IDs
    • optionally add per-skill overrides via key=value inputs

Skillware Wrapper Module

  • Added rooms/skills_cli.py:
    • lazy Skillware loader access
    • discovery normalization
    • inspect payload normalization
    • lightweight expertise-based suggestion matching

Documentation

  • Updated README.md to reflect optional Skillware support in project-native language.
  • Added docs/SKILLWARE.md as dedicated integration/usage guide.
  • Updated:
    • docs/ARCHITECTURE.md
    • docs/EXAMPLES.md
    • docs/TESTING.md

Tests

  • Expanded tests/test_cli.py with command and wizard-assignment coverage.
  • Added tests/test_skills_cli.py for wrapper discovery/inspect/suggest behavior.

Behavior Notes

  • Skillware remains optional.
  • If Skillware is unavailable, skill commands/wizard paths return guidance instead of crashing.
  • Core session workflows are unaffected for users not using skills.

Validation

.\venv\Scripts\python.exe -m pytest
  • Result: 54 passed

Linked Issue

Closes #57

Introduce optional skills list/inspect/suggest commands and custom-agent wizard skill assignment with graceful no-Skillware handling, plus tests and docs updates for the integrated skill-aware UX.
@rosspeili rosspeili merged commit aae16eb into ARPAHLS:main Jun 17, 2026
1 check passed
@rosspeili rosspeili deleted the feat/issue-57-skillware-cli-wrapper branch June 17, 2026 10:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(cli): add Rooms-native Skillware wrapper commands and wizard-based skill assignment

1 participant