Diablo_ClaudeMD_Ricing_example/skills/deep-research/CHANGELOG.md
diablo 50fa79407d
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
CoM Claude Command Center — sanitized public configuration
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
2026-06-10 02:02:03 -04:00

2.6 KiB
Raw Permalink Blame History

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 parameters
  • research_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 saving
  • scripts/run_deep_research.py - Enhanced progress messages
  • SKILL.md - Comprehensive documentation updates

Released: October 25, 2025