@olegkoval/agent-skills 1.17.0 → 1.18.0

package/.claude-plugin/marketplace.json

@@ -4,13 +4,13 @@
     "name": "Oleg Koval"
   },
   "metadata": {
-    "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools."
+    "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools."
   },
   "plugins": [
     {
       "name": "olko-agent-skills",
       "source": "./",
-      "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools."
+      "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools."
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "olko-agent-skills",
-  "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools.",
-  "version": "1.16.0",
+  "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.",
+  "version": "1.17.0",
   "author": {
     "name": "Oleg Koval"
   },

package/.grok-plugin/index.json

@@ -0,0 +1,120 @@
+{
+  "name": "agent-skills",
+  "plugins": [
+    {
+      "name": "olko:self-critique",
+      "source": "./packages/software-development/self-critique/adapters/grok",
+      "description": "Adversarially critique your own last answer: spawn a critic agent that verifies claims against live sources, finds the related issue or pattern you missed, then loop until satisfied and report where you were wrong, iterations-to-satisfy, the numeric improvement, and a final score."
+    },
+    {
+      "name": "olko:docs-index-keeper",
+      "source": "./packages/software-development/docs-index-keeper/adapters/grok",
+      "description": "Keep a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows."
+    },
+    {
+      "name": "olko:semantic-release-beta",
+      "source": "./packages/software-development/semantic-release-beta/adapters/grok",
+      "description": "Set up semantic-release-npm-github-publish with stable main releases and prerelease beta releases on a beta branch."
+    },
+    {
+      "name": "olko:gh-cli",
+      "source": "./packages/software-development/gh-cli/adapters/grok",
+      "description": "Use the GitHub CLI effectively for repositories, PRs, Actions, releases, and more."
+    },
+    {
+      "name": "olko:git-commit",
+      "source": "./packages/software-development/git-commit/adapters/grok",
+      "description": "Create conventional commits with diff-aware staging and message generation."
+    },
+    {
+      "name": "olko:gallery",
+      "source": "./packages/photography/gallery/adapters/grok",
+      "description": "Create photo galleries with AI-assisted layout curation and sequencing."
+    },
+    {
+      "name": "olko:promptctl",
+      "source": "./packages/software-development/promptctl/adapters/grok",
+      "description": "Use promptctl for template-based prompt engineering, scoring, and workflow automation."
+    },
+    {
+      "name": "olko:fill-music-player",
+      "source": "./packages/music/fill-music-player/adapters/grok",
+      "description": "Fill a portable music player with a curated random selection from a source music library while balancing formats, artists, albums, and capacity."
+    },
+    {
+      "name": "olko:product-builder",
+      "source": "./packages/software-development/product-builder/adapters/grok",
+      "description": "Build a full-stack web application or SaaS product from a user description using production-oriented defaults."
+    },
+    {
+      "name": "olko:mvp-oneshot",
+      "source": "./packages/software-development/mvp-oneshot/adapters/grok",
+      "description": "Turn a rough product idea into a shippable one-week MVP in one pass via a four-role prompt chain: scope a build prompt, ruthlessly trim it, plan the build, and self-review the vertical slice."
+    },
+    {
+      "name": "olko:starter-rules",
+      "source": "./packages/software-development/starter-rules/adapters/grok",
+      "description": "Load and enforce hard rules for every oleg-koval/* starter: 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, no comments, KISS/DRY/SOLID."
+    },
+    {
+      "name": "olko:review-past-performance",
+      "source": "./packages/software-development/review-past-performance/adapters/grok",
+      "description": "Self-improvement loop that pulls the last 24h of ICM memories, git history, and skill analytics to detect repeated mistakes, slow workflows, and missing coverage, then proposes 1-3 concrete improvements."
+    },
+    {
+      "name": "olko:relay",
+      "source": "./packages/software-development/relay/adapters/grok",
+      "description": "Use claude-relay to run long or rate-limit-prone tasks autonomously across subscription accounts."
+    },
+    {
+      "name": "olko:open-source-publisher",
+      "source": "./packages/software-development/open-source-publisher/adapters/grok",
+      "description": "Prepare an open-source repository for public publishing with a minimal icon, social preview image, GitHub Pages site, README standardization, CI/CD checks, release hygiene, optional donation setup, and optional motion previews for generated static images."
+    },
+    {
+      "name": "olko:viral-launch",
+      "source": "./packages/marketing/viral-launch/adapters/grok",
+      "description": "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops."
+    },
+    {
+      "name": "olko:search-console-indexing-audit",
+      "source": "./packages/marketing/search-console-indexing-audit/adapters/grok",
+      "description": "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
+    },
+    {
+      "name": "olko:cloudflare-block-countries",
+      "source": "./packages/software-development/cloudflare-block-countries/adapters/grok",
+      "description": "Block specific countries via Cloudflare WAF Custom Rules using the Cloudflare API. Handles creating new rulesets and updating existing ones across single or multiple zones."
+    },
+    {
+      "name": "olko:obsidian-pr-sync",
+      "source": "./packages/software-development/obsidian-pr-sync/adapters/grok",
+      "description": "Fetch open GitHub PRs assigned to you or requesting your review, and write a grouped, age-sorted '## PRs to review' section into today's Obsidian daily note. Idempotent — re-running replaces the section."
+    },
+    {
+      "name": "olko:obsidian-task-rollover",
+      "source": "./packages/software-development/obsidian-task-rollover/adapters/grok",
+      "description": "Bullet-journal end-of-day task migration: copy unchecked tasks from today's Obsidian daily note to the next workday's note under '## Carried over', and mark them [>] in the source. Skips weekends, idempotent."
+    },
+    {
+      "name": "olko:apple-store-submit",
+      "source": "./packages/software-development/apple-store-submit/adapters/grok",
+      "description": "Handle Apple App Store rejection emails end-to-end: parse rejection reasons, plan fixes, implement code changes, navigate App Store Connect, and resubmit."
+    },
+    {
+      "name": "olko:macos-menubar-app",
+      "source": "./packages/software-development/macos-menubar-app/adapters/grok",
+      "description": "Build a production-quality macOS menubar or notch app in SwiftUI — MenuBarExtra, sandbox entitlements, keyboard shortcuts, sound effects, accessibility permissions, and App Store preparation."
+    },
+    {
+      "name": "olko:skill-budget-audit",
+      "source": "./packages/software-development/skill-budget-audit/adapters/grok",
+      "description": "Diagnose and fix Claude Code skill context budget overflow — identify heavy plugin bundles, remove domain-specific ones, and restore skill discoverability."
+    },
+    {
+      "name": "olko:crash-course",
+      "source": "./packages/software-development/crash-course/adapters/grok",
+      "description": "Expert tutor for rapid, source-grounded learning of any topic: a timed 4-hour sprint plus cheat-sheet, learning-ladder, quiz-me, Feynman, and resource-curation modes."
+    }
+  ]
+}

package/README.md

@@ -1,15 +1,15 @@
 <div align="center">
   <h1>agent skills</h1>
-  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, Copilot, Windsurf, Kiro, and other skill-aware tools.</strong></p>
+  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.</strong></p>
   <p>
     <img src="https://img.shields.io/badge/license-MIT-16a34a" alt="MIT license">
     <img src="https://img.shields.io/badge/skills-23-2563eb" alt="23 skills">
-    <img src="https://img.shields.io/badge/platforms-Codex%20%7C%20Claude%20%7C%20Cursor%20%7C%20Copilot%20%7C%20Windsurf%20%7C%20Kiro-111827" alt="Codex Claude Cursor Copilot Windsurf Kiro">
+    <img src="https://img.shields.io/badge/platforms-Codex%20%7C%20Claude%20%7C%20Cursor%20%7C%20Grok%20%7C%20Copilot%20%7C%20Windsurf%20%7C%20Kiro-111827" alt="Codex Claude Cursor Grok Copilot Windsurf Kiro">
     <img src="https://img.shields.io/badge/status-public%20catalog-16a34a" alt="Public catalog">
   </p>
 </div>
 
-Agent-agnostic skill collection for Codex, Claude, Cursor, and other skill-aware tools.
+Agent-agnostic skill collection for Codex, Claude, Cursor, Grok, and other skill-aware tools.
 
 These skills are opinionated by design. They encode working defaults, preferred tools, and repeatable workflows instead of trying to be neutral snippets. Treat them as starting points with taste: useful out of the box, easy to inspect, and specific enough for an agent to execute consistently.
 
@@ -76,6 +76,27 @@ claude --plugin-dir /path/to/agent-skills
 
 </details>
 
+<details>
+<summary><b>Grok</b></summary>
+
+Grok (xAI) supports plugins via marketplace or direct path. Add this catalog as a marketplace source:
+
+```bash
+grok plugin marketplace add oleg-koval/agent-skills
+```
+
+Or for local development / direct use:
+
+```bash
+grok agent --plugin-dir /path/to/agent-skills
+```
+
+Skills are available via their `olko:*` names or through the installed plugin. Grok discovers `plugin.json` + `skills/` (and falls back to `.claude-plugin/` manifests for compatibility).
+
+The repo generates `.grok-plugin/index.json` for structured plugin discovery.
+
+</details>
+
 <details>
 <summary><b>Cursor</b></summary>
 
@@ -204,6 +225,7 @@ When adding or changing a skill:
 | Claude Code | `.claude-plugin/marketplace.json` | Marketplace plugin registry |
 | Claude Code | `.claude-plugin/plugin.json` | Plugin manifest |
 | Cursor | `.cursor-plugin/index.json` | Plugin index |
+| Grok | `.grok-plugin/index.json` | Plugin index (plus `.claude-plugin/` compatibility) |
 | GitHub Copilot | `.github/copilot-instructions.md` | Repository instructions |
 | GitHub Copilot | `.github/prompts/*.prompt.md` | Per-skill prompt files |
 | Windsurf | `.windsurf/rules/*.md` | Cascade rules |
@@ -223,6 +245,7 @@ packages/{category}/{skill}/
     ├── codex/
     ├── claude/
     ├── cursor/
+    ├── grok/
     ├── windsurf/
     └── kiro/
 ```

package/catalog/skills.json

@@ -19,7 +19,8 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "grok"
       ]
     },
     {
@@ -41,7 +42,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -64,7 +66,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -86,7 +89,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -106,7 +110,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -127,7 +132,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -148,7 +154,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -170,7 +177,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -192,7 +200,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -216,7 +225,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -240,7 +250,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -263,7 +274,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -279,7 +291,8 @@
         "claude-relay"
       ],
       "adapters": [
-        "claude"
+        "claude",
+        "grok"
       ]
     },
     {
@@ -304,7 +317,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -327,7 +341,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -352,7 +367,8 @@
         "hermes",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -374,7 +390,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -396,7 +413,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -418,7 +436,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -442,7 +461,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -466,7 +486,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     },
     {
@@ -484,7 +505,8 @@
         "performance"
       ],
       "adapters": [
-        "claude"
+        "claude",
+        "grok"
       ]
     },
     {
@@ -507,7 +529,8 @@
         "cursor",
         "copilot",
         "windsurf",
-        "kiro"
+        "kiro",
+        "grok"
       ]
     }
   ]

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
-  "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools.",
+  "description": "Agent-agnostic skill catalog for Codex, Claude, Cursor, Grok, Copilot, Windsurf, Kiro, and other skill-aware tools.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -25,6 +25,7 @@
     "packages",
     ".claude-plugin",
     ".cursor-plugin",
+    ".grok-plugin",
     ".windsurf",
     ".kiro",
     "scripts",

package/packages/marketing/search-console-indexing-audit/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:search-console-indexing-audit",
+  "version": "0.1.0",
+  "description": "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals.",
+  "skills": "skills/"
+}

package/packages/marketing/search-console-indexing-audit/adapters/grok/skills/search-console-indexing-audit/SKILL.md

@@ -0,0 +1,69 @@
+---
+
+name: search-console-indexing-audit
+description: Analyze Google Search Console Coverage or indexing CSV exports and correlate them with repo and live-site SEO signals. Use for Chart.csv, Metadata.csv, Critical issues.csv, Non-critical issues.csv, sitemap/robots/canonical indexing problems, "Discovered - currently not indexed", redirect indexing buckets, or requests to fix Google indexing coverage.
+license: MIT
+allowed-tools: Bash, Read, Write
+compatibility: Codex, Claude Code, Cursor, Pi, Hermes, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - seo
+    - google-search-console
+    - indexing
+    - sitemap
+    - canonical
+
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# search-console-indexing-audit
+
+Use this skill to turn Google Search Console Coverage exports into a concrete indexing fix plan.
+
+## Workflow
+
+1. Read the export directory first:
+   - `Chart.csv` for indexed/not-indexed trend and impressions
+   - `Metadata.csv` for property context such as sitemap scope
+   - `Critical issues.csv` and `Non-critical issues.csv` for issue buckets
+2. Run the summarizer when the standard CSV files are present:
+
+```bash
+python3 <skill-dir>/scripts/summarize_gsc_coverage.py <export-dir>
+python3 <skill-dir>/scripts/summarize_gsc_coverage.py <export-dir> --json
+```
+
+3. Inspect the target repo for SEO sources of truth:
+   - sitemap generation and whether listed URLs are canonical, indexable HTML pages
+   - robots rules, sitemap URL, and host hints
+   - canonical metadata, `metadataBase`, Open Graph URL base, and per-route `noindex`
+   - redirects across apex/www, http/https, trailing slash, moved routes, and legacy paths
+4. Check live URLs when network access is available:
+
+```bash
+curl -sS -I https://example.com/sitemap.xml
+curl -sS https://example.com/sitemap.xml
+curl -sS https://example.com/robots.txt
+curl -sS https://example.com/page | rg -o '<link rel="canonical"[^>]*>|<meta name="robots"[^>]*>'
+curl -sS -I -L --max-redirs 5 https://example.com/page
+```
+
+5. Map GSC buckets to fixes:
+   - `Page with redirect`: remove redirected URLs from sitemap and canonicals; submit only final 200 URLs.
+   - `Redirect error`: inspect redirect chains, protocol/host loops, blocked destinations, and non-200 final responses.
+   - `Alternate page with proper canonical tag`: usually acceptable; verify sitemap does not include alternates.
+   - `Discovered - currently not indexed`: improve crawl signals first: clean sitemap, canonical consistency, internal links, content quality, stable 200 responses, and lastmod accuracy.
+   - `Excluded by noindex`: verify it is intentional and keep those URLs out of sitemap.
+
+## Output
+
+Report:
+
+- Export summary: date range, indexed/not-indexed trend, issue buckets, and limitations.
+- Likely root cause, with evidence from files or live HTTP responses.
+- Prioritized fixes, smallest reliable change first.
+- Verification steps for local tests, build, live sitemap/robots/canonical checks, and Search Console validation.
+
+Call out when the export is aggregate-only and does not contain affected URL examples. Do not infer exact URLs unless the CSVs or live sitemap provide them.

package/packages/marketing/search-console-indexing-audit/adapters/grok/skills/search-console-indexing-audit/scripts/summarize_gsc_coverage.py

@@ -0,0 +1,151 @@
+#!/usr/bin/env python3
+"""Summarize Google Search Console Coverage CSV exports."""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import json
+from pathlib import Path
+from typing import Any
+
+
+STANDARD_FILES = {
+    "chart": "Chart.csv",
+    "metadata": "Metadata.csv",
+    "critical": "Critical issues.csv",
+    "non_critical": "Non-critical issues.csv",
+}
+
+
+def read_rows(path: Path) -> list[dict[str, str]]:
+    if not path.exists():
+        return []
+    with path.open(newline="", encoding="utf-8-sig") as handle:
+        return [
+            {key: (value or "").strip() for key, value in row.items()}
+            for row in csv.DictReader(handle)
+        ]
+
+
+def int_or_none(value: str) -> int | None:
+    if value == "":
+        return None
+    try:
+        return int(value.replace(",", ""))
+    except ValueError:
+        return None
+
+
+def chart_summary(rows: list[dict[str, str]]) -> dict[str, Any]:
+    points = []
+    for row in rows:
+        points.append(
+            {
+                "date": row.get("Date", ""),
+                "not_indexed": int_or_none(row.get("Not indexed", "")),
+                "indexed": int_or_none(row.get("Indexed", "")),
+                "impressions": int_or_none(row.get("Impressions", "")),
+            }
+        )
+
+    indexed_points = [
+        point for point in points if point["indexed"] is not None or point["not_indexed"] is not None
+    ]
+    first = indexed_points[0] if indexed_points else None
+    last = indexed_points[-1] if indexed_points else None
+
+    return {
+        "date_range": [points[0]["date"], points[-1]["date"]] if points else None,
+        "first_indexing_point": first,
+        "latest_indexing_point": last,
+        "indexed_delta": None if not first or not last else (last["indexed"] or 0) - (first["indexed"] or 0),
+        "not_indexed_delta": None
+        if not first or not last
+        else (last["not_indexed"] or 0) - (first["not_indexed"] or 0),
+        "impressions_total": sum(point["impressions"] or 0 for point in points),
+    }
+
+
+def issue_summary(rows: list[dict[str, str]]) -> list[dict[str, Any]]:
+    issues = []
+    for row in rows:
+        reason = row.get("Reason", "")
+        if not reason:
+            continue
+        issues.append(
+            {
+                "reason": reason,
+                "source": row.get("Source", ""),
+                "validation": row.get("Validation", ""),
+                "pages": int_or_none(row.get("Pages", "")) or 0,
+            }
+        )
+    return sorted(issues, key=lambda issue: issue["pages"], reverse=True)
+
+
+def load_export(export_dir: Path) -> dict[str, Any]:
+    files = {key: export_dir / filename for key, filename in STANDARD_FILES.items()}
+    metadata_rows = read_rows(files["metadata"])
+    return {
+        "export_dir": str(export_dir),
+        "metadata": {row.get("Property", ""): row.get("Value", "") for row in metadata_rows},
+        "chart": chart_summary(read_rows(files["chart"])),
+        "critical_issues": issue_summary(read_rows(files["critical"])),
+        "non_critical_issues": issue_summary(read_rows(files["non_critical"])),
+        "missing_files": [filename for filename in STANDARD_FILES.values() if not (export_dir / filename).exists()],
+    }
+
+
+def print_markdown(summary: dict[str, Any]) -> None:
+    chart = summary["chart"]
+    latest = chart["latest_indexing_point"] or {}
+    print("# Search Console Coverage Summary")
+    print()
+    print(f"- Export: `{summary['export_dir']}`")
+    if chart["date_range"]:
+        print(f"- Date range: {chart['date_range'][0]} to {chart['date_range'][1]}")
+    print(f"- Latest indexed: {latest.get('indexed', 'n/a')}")
+    print(f"- Latest not indexed: {latest.get('not_indexed', 'n/a')}")
+    print(f"- Total impressions in chart: {chart['impressions_total']}")
+    if summary["metadata"]:
+        print(f"- Metadata: {summary['metadata']}")
+    if summary["missing_files"]:
+        print(f"- Missing standard files: {', '.join(summary['missing_files'])}")
+
+    for label, issues in (
+        ("Critical Issues", summary["critical_issues"]),
+        ("Non-Critical Issues", summary["non_critical_issues"]),
+    ):
+        print()
+        print(f"## {label}")
+        if not issues:
+            print("- None reported")
+            continue
+        for issue in issues:
+            print(
+                f"- {issue['reason']}: {issue['pages']} pages"
+                f" ({issue['source']}, validation: {issue['validation']})"
+            )
+
+    print()
+    print("## Notes")
+    print("- Standard Coverage exports are aggregate reports; they may not include affected URL examples.")
+    print("- Redirect and canonical buckets should be checked against sitemap URLs and live canonical tags.")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("export_dir", type=Path)
+    parser.add_argument("--json", action="store_true", help="Print machine-readable JSON")
+    args = parser.parse_args()
+
+    summary = load_export(args.export_dir)
+    if args.json:
+        print(json.dumps(summary, indent=2, sort_keys=True))
+    else:
+        print_markdown(summary)
+
+
+if __name__ == "__main__":
+    main()