Some checks are pending
CI — CoM Config Validation / Validate JSON Configs (push) Waiting to run
CI — CoM Config Validation / Validate YAML Configs (push) Waiting to run
CI — CoM Config Validation / Lint Shell Scripts (push) Waiting to run
CI — CoM Config Validation / Secret Detection (push) Waiting to run
CI — CoM Config Validation / Lint Markdown (push) Waiting to run
CI — CoM Config Validation / Validate CODEOWNERS (push) Waiting to run
Public, sanitized mirror of an AI orchestration command center: agents, skills, MCP servers, slash-command workflows. All infrastructure identifiers, hostnames, mesh IPs/subnets, repo paths, maintainer identity, and hardware fleet specifics scrubbed to <placeholders>; session debug logs and host-specific memory removed. No live credentials. Verified clean by automated leak sweep. See SANITIZATION.md. churchofmalware.org . authorized research only
2.6 KiB
2.6 KiB
Deep Research Skill - Changelog
Version 2.0 - Token-Optimized with Automatic Markdown Saving
New Features
Automatic Markdown Saving
- Research reports are now automatically saved to timestamped markdown files
- Default filename:
research_report_YYYYMMDD_HHMMSS.md - Includes complete report, sources, and metadata footer
- No manual intervention needed
Token-Efficient Long-Running Task Handling
- Optimized for 10-20 minute deep research queries
- Synchronous execution (blocking subprocess, no polling)
- No intermediate status checks during wait
- Token savings: ~19,000 tokens per research query vs. polling approach
New Command-Line Options
--output-file <path> # Custom output file path
--no-save # Disable automatic markdown saving
Improvements
deep_research.py Updates
- Added automatic file saving with timestamped filenames
- Enhanced markdown formatting with metadata footer
- Added datetime import for timestamp generation
- Success confirmation message with absolute file path
run_deep_research.py Updates
- Better progress messages with estimated time (10-20 minutes)
- Timeout display in both seconds and minutes
- Completion confirmation message
- Improved error handling
SKILL.md Updates
- Added "Token-Efficient Workflow" section explaining optimization
- Documented automatic markdown saving feature
- Added token savings calculations (~20K tokens saved)
- Updated all usage examples
- Enhanced troubleshooting section
Technical Details
Token Optimization Strategy:
- Traditional approach: 40 status checks × 500 tokens = 20,000 tokens
- Optimized approach: Single wait = ~1,000 tokens
- Savings: ~95% reduction in token usage during wait
File Generation:
research_prompt_YYYYMMDD_HHMMSS.txt- Enhanced prompt with parametersresearch_report_YYYYMMDD_HHMMSS.md- Complete markdown report
Usage Example
# Basic usage (auto-saves to research_report_20251025_150402.md)
python3 scripts/run_deep_research.py "Art as sense-making"
# Custom output location
python3 assets/deep_research.py --prompt-file prompt.txt --output-file my_research.md
# No automatic saving (terminal only)
python3 assets/deep_research.py --prompt-file prompt.txt --no-save
Breaking Changes
None - all changes are backward compatible. The skill maintains full compatibility with existing workflows.
Files Modified
assets/deep_research.py- Added automatic markdown savingscripts/run_deep_research.py- Enhanced progress messagesSKILL.md- Comprehensive documentation updates
Released: October 25, 2025