skill-seekers-reference

firefrost-gaming/skill-seekers-reference

Files

yusyus f896b654e3 feat(cli): Phase 3 - Progressive disclosure with better hints and examples

Improvements:
1. **Better help text formatting:**
   - Added RawDescriptionHelpFormatter to preserve example formatting
   - Examples now display cleanly instead of being collapsed

2. **Enhanced epilog with 4 sections:**
   - Examples: Usage examples for all 5 source types
   - Source Detection: Clear rules for auto-detection
   - Need More Options?: Prominent hints for source-specific help
   - Common Workflows: Quick/standard/comprehensive presets

3. **Implemented progressive disclosure:**
   - --help-web: Shows universal + web-specific arguments
   - --help-github: Shows universal + GitHub-specific arguments
   - --help-local: Shows universal + local-specific arguments
   - --help-pdf: Shows universal + PDF-specific arguments
   - --help-advanced: Shows advanced/rare options
   - --help-all: Shows all 120+ options

4. **Improved discoverability:**
   - Default help shows 13 universal arguments (clean, focused)
   - Clear hints guide users to source-specific options
   - Examples show common patterns for each source type
   - Workflows section shows preset usage patterns

Result:
✅ Much clearer help text with proper formatting
✅ Progressive disclosure reduces cognitive load
✅ Easy to discover source-specific options
✅ Better UX for both beginners and power users
✅ All 46 tests passing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-02-15 14:56:19 +03:00

benchmark

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

cli

feat(cli): Phase 3 - Progressive disclosure with better hints and examples

2026-02-15 14:56:19 +03:00

embedding

style: Format all Python files with ruff

2026-02-08 14:42:27 +03:00

mcp

style: Format all Python files with ruff