# last30days Documentation

> Technical reference for the multi-source Agent Skills research package: slash-command and engine entry points, v3 retrieval pipeline, configuration layers, synthesis output contract, and operator workflows across 50+ agent harnesses.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca)
- [GitHub repository](https://github.com/mvanhorn/last30days-skill)

## Repository

- Repository: mvanhorn/last30days-skill

- Generated: 2026-06-04T23:26:24.258Z
- Updated: 2026-06-05T19:21:29.664Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 22

## Pages

- [Overview](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/01-overview.md): What the Skill exposes, primary slash-command vs engine paths, zero-config sources, and the shortest successful research path.
- [Installation](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/02-installation.md): Install via Claude Code marketplace, npx skills add for Agent Skills hosts, Hermes, live-edit symlinks, and version sync expectations.
- [Quickstart](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/03-quickstart.md): First /last30days invocation, first-run setup wizard signals, saved output location, and --diagnose verification.
- [Skill, engine, and harness](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/04-skill-engine-and-harness.md): Project-specific boundaries between the Agent Skills package, Python engine, and multi-harness runtimes that load the skill.
- [Query types](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/05-query-types.md): QUERY_TYPE classification (GENERAL, NEWS, PROMPTING, RECOMMENDATIONS, COMPARISON), intent parsing, and engine pre-flight refusal paths.
- [Research pipeline](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/06-research-pipeline.md): v3 orchestration: planner sub-queries, parallel source fan-out, fusion, clustering, dedupe, rerank, and depth profiles (--quick / default / --deep).
- [Output contract](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/07-output-contract.md): Badge line, LAWs voice contract, --emit modes (compact, json, context, md, html), evidence blocks, and footer pass-through rules.
- [Configure sources](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/08-configure-sources.md): Credential layers (.env paths, keychain), per-source API keys, INCLUDE_SOURCES, setup wizard auto-actions, and --diagnose availability checks.
- [Model clients](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/09-model-clients.md): Per-harness install patterns: Claude Code marketplace, npx skills -a targets, Codex/Cursor/Gemini, Hermes, OpenClaw, and stale-install avoidance.
- [Comparison mode](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/10-comparison-mode.md): --competitors discovery fan-out, --competitors-list and --competitors-plan JSON schema, per-entity Step 0.55 targeting, and comparison synthesis template.
- [HTML briefs](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/11-html-briefs.md): Shareable offline HTML artifacts via --emit=html, --synthesis-file, save paths under LAST30DAYS_MEMORY_DIR, and SKILL.md-driven save flow.
- [Trend monitoring](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/12-trend-monitoring.md): SQLite --store persistence, watchlist.py scheduling and delivery, briefing.py digests, and recommended baseline cadence.
- [Per-client setup](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/13-per-client-setup.md): Project-scoped .claude/last30days.env, save-dir and --save-suffix isolation, category peer subreddits, and recurring --competitors-plan templates.
- [Configuration reference](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/14-configuration-reference.md): Environment variables, .env lookup order, reasoning provider priority, web-backend priority, output paths, and trend-monitoring toggles.
- [CLI reference](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/15-cli-reference.md): last30days.py positional topic, all argparse flags, --emit choices, targeting flags, and direct CLI vs slash-command constraints.
- [Data sources](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/16-data-sources.md): Per-platform retrieval modules, keyless vs keyed sources, --search alias map, and engagement scoring inputs by source.
- [Skill contract](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/17-skill-contract.md): SKILL.md runtime authority: STEP 0 stale-clone guard, pre-flight protocol, engine invocation rules, and SKILL_DIR substitution.
- [Comparison recipes](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/18-comparison-recipes.md): Copy-paste comparison workflows: vs-topic phrasing, --competitors fan-out, and multi-entity Head-to-Head table expectations.
- [Prompting recipes](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/19-prompting-recipes.md): PROMPTING query workflows: community technique extraction, KEY PATTERNS output shape, and copy-paste prompt generation patterns.
- [Troubleshooting](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/20-troubleshooting.md): --diagnose probes, missing-source recovery, stale Claude marketplace clones, thin results, and documented failure modes.
- [Develop and test](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/21-develop-and-test.md): uv/pytest workflow, coverage omit rules, validate and security CI, optional search-quality eval, and contributor constraints from AGENTS.md.
- [Beta channel](https://grok-wiki.com/public/docs/mvanhorn-last30days-skill-50b5421a8cca/pages/22-beta-channel.md): Parallel /last30days-beta install from the private repo, promotion workflow, and where client-specific customizations belong.

## Source Files

- `.agents/plugins/marketplace.json`
- `.claude-plugin/marketplace.json`
- `.claude-plugin/plugin.json`
- `.github/workflows/security.yml`
- `.github/workflows/validate.yml`
- `AGENTS.md`
- `CHANGELOG.md`
- `CONCEPTS.md`
- `CONFIGURATION.md`
- `docs/how-search-works.md`
- `docs/releases/v3.0.9.md`
- `docs/search-quality-eval.md`
- `docs/solutions/architecture/search-quality-eval-manual-by-default-2026-05-10.md`
- `docs/solutions/workflow-issues/release-consistency-test-cascade-2026-05-16.md`
- `fixtures/eval_topics.json`
- `gemini-extension.json`
- `HERMES_SETUP.md`
- `pyproject.toml`
- `README.md`
- `skills/last30days/agents/openai.yaml`
- `skills/last30days/references/save-html-brief.md`
- `skills/last30days/scripts/briefing.py`
- `skills/last30days/scripts/evaluate_search_quality.py`
- `skills/last30days/scripts/last30days.py`
- `skills/last30days/scripts/lib/bird_x.py`
- `skills/last30days/scripts/lib/categories.py`
- `skills/last30days/scripts/lib/cluster.py`
- `skills/last30days/scripts/lib/competitors.py`
- `skills/last30days/scripts/lib/dedupe.py`
- `skills/last30days/scripts/lib/env.py`
- `skills/last30days/scripts/lib/fanout.py`
- `skills/last30days/scripts/lib/fusion.py`
- `skills/last30days/scripts/lib/github.py`
- `skills/last30days/scripts/lib/html_render.py`
- `skills/last30days/scripts/lib/pipeline.py`
- `skills/last30days/scripts/lib/planner.py`
- `skills/last30days/scripts/lib/polymarket.py`
- `skills/last30days/scripts/lib/preflight.py`
- `skills/last30days/scripts/lib/providers.py`
- `skills/last30days/scripts/lib/query.py`
- `skills/last30days/scripts/lib/reddit_public.py`
- `skills/last30days/scripts/lib/render.py`
- `skills/last30days/scripts/lib/rerank.py`
- `skills/last30days/scripts/lib/schema.py`
- `skills/last30days/scripts/lib/setup_wizard.py`
- `skills/last30days/scripts/lib/skill_meta.py`
- `skills/last30days/scripts/lib/youtube_yt.py`
- `skills/last30days/scripts/setup-keychain.sh`
- `skills/last30days/scripts/store.py`
- `skills/last30days/scripts/verify_v3.py`
- `skills/last30days/scripts/watchlist.py`
- `skills/last30days/SKILL.md`
- `tests/test_cli_competitors.py`
- `tests/test_competitor_fanout.py`
- `tests/test_pipeline_v3.py`
- `tests/test_regression.py`
- `tests/test_render_comparison_multi.py`
- `tests/test_watchlist_commands.py`