@olegkoval/agent-skills 1.0.1 → 1.2.0

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.0.0",
+  "version": "1.1.0",
   "author": {
     "name": "Oleg Koval"
   },
@@ -18,6 +18,8 @@
     "./packages/software-development/promptctl",
     "./packages/music/fill-music-player",
     "./packages/software-development/product-builder",
-    "./packages/marketing/viral-launch"
+    "./packages/software-development/open-source-publisher",
+    "./packages/marketing/viral-launch",
+    "./packages/marketing/search-console-indexing-audit"
   ]
 }

package/.cursor-plugin/index.json

@@ -46,10 +46,20 @@
       "source": "./packages/software-development/product-builder/adapters/cursor",
       "description": "Build a full-stack web application or SaaS product from a user description using production-oriented defaults."
     },
+    {
+      "name": "olko:open-source-publisher",
+      "source": "./packages/software-development/open-source-publisher/adapters/cursor",
+      "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, and optional donation setup."
+    },
     {
       "name": "olko:viral-launch",
       "source": "./packages/marketing/viral-launch/adapters/cursor",
       "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/cursor",
+      "description": "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
     }
   ]
 }

package/README.md

@@ -3,7 +3,7 @@
   <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, 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-10-2563eb" alt="10 skills">
+    <img src="https://img.shields.io/badge/skills-11-2563eb" alt="11 skills">
     <img src="https://img.shields.io/badge/platforms-Codex%20%7C%20Claude%20%7C%20Cursor%20%7C%20Copilot-111827" alt="Codex Claude Cursor Copilot">
     <img src="https://img.shields.io/badge/status-public%20catalog-16a34a" alt="Public catalog">
   </p>
@@ -116,7 +116,7 @@ packages/{category}/{skill}/adapters/
 
 </details>
 
-## All 10 Skills
+## All 11 Skills
 
 These packages are the entry points. Each one is a structured workflow with concrete trigger conditions and execution steps. You can reference any skill directly by its `olko:*` lookup name.
 
@@ -143,6 +143,7 @@ These packages are the entry points. Each one is a structured workflow with conc
 | Skill | What It Does | Use When |
 |-------|-------------|----------|
 | [viral-launch](packages/marketing/viral-launch/SKILL.md) | Sets up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops | Preparing a repo, product, open-source package, waitlist, or creator tool for public launch |
+| [search-console-indexing-audit](packages/marketing/search-console-indexing-audit/SKILL.md) | Audits Google Search Console Coverage exports against sitemap, robots, canonical, redirect, and noindex signals | Diagnosing GSC indexing issues such as redirects, canonical alternates, and discovered but not indexed pages |
 
 ### Photography
 

package/catalog/skills.json

@@ -177,6 +177,29 @@
         "copilot"
       ]
     },
+    {
+      "name": "open-source-publisher",
+      "lookupName": "olko:open-source-publisher",
+      "category": "software-development",
+      "path": "packages/software-development/open-source-publisher",
+      "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, and optional donation setup.",
+      "tags": [
+        "open-source",
+        "github",
+        "readme",
+        "branding",
+        "github-pages",
+        "ci",
+        "release",
+        "social-image"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot"
+      ]
+    },
     {
       "name": "viral-launch",
       "lookupName": "olko:viral-launch",
@@ -197,6 +220,27 @@
         "cursor",
         "copilot"
       ]
+    },
+    {
+      "name": "search-console-indexing-audit",
+      "lookupName": "olko:search-console-indexing-audit",
+      "category": "marketing",
+      "path": "packages/marketing/search-console-indexing-audit",
+      "description": "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals.",
+      "tags": [
+        "seo",
+        "google-search-console",
+        "indexing",
+        "sitemap",
+        "canonical",
+        "robots"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot"
+      ]
     }
   ]
 }

package/collections/marketing.json

@@ -1,5 +1,5 @@
 {
   "name": "marketing",
-  "description": "Skills for project marketing, public launches, positioning, and shareable growth workflows.",
-  "packages": ["viral-launch"]
+  "description": "Skills for project marketing, public launches, positioning, SEO, indexing, and shareable growth workflows.",
+  "packages": ["viral-launch", "search-console-indexing-audit"]
 }

package/collections/software-development.json

@@ -8,6 +8,7 @@
     "gh-cli",
     "git-commit",
     "promptctl",
+    "open-source-publisher",
     "product-builder"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "private": false,
   "publishConfig": {
     "access": "public"

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

@@ -0,0 +1,64 @@
+---
+
+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.
+metadata:
+  author: Oleg Koval
+  tags:
+    - seo
+    - google-search-console
+    - indexing
+    - sitemap
+    - canonical
+
+---
+
+# 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/claude/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "olko-search-console-indexing-audit",
+  "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/claude/skills/search-console-indexing-audit/SKILL.md

@@ -0,0 +1,66 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+
+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.
+metadata:
+  author: Oleg Koval
+  tags:
+    - seo
+    - google-search-console
+    - indexing
+    - sitemap
+    - canonical
+
+---
+
+# 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/claude/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()

package/packages/marketing/search-console-indexing-audit/adapters/codex/README.md

@@ -0,0 +1,3 @@
+# Codex adapter
+
+Use the canonical skill directly from `packages/marketing/search-console-indexing-audit/SKILL.md`.

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

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

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

@@ -0,0 +1,66 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+
+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.
+metadata:
+  author: Oleg Koval
+  tags:
+    - seo
+    - google-search-console
+    - indexing
+    - sitemap
+    - canonical
+
+---
+
+# 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.