@olegkoval/agent-skills 1.17.0 → 1.19.0

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,6 +529,31 @@
         "cursor",
         "copilot",
         "windsurf",
+        "kiro",
+        "grok"
+      ]
+    },
+    {
+      "name": "qodoloop",
+      "lookupName": "olko:qodoloop",
+      "category": "software-development",
+      "path": "packages/software-development/qodoloop",
+      "description": "Iteratively drives a GitHub PR to zero unresolved Qodo findings — reads each finding's own Agent Prompt, applies the fix, replies to the thread, resolves it, pushes, and waits for Qodo's next pass.",
+      "tags": [
+        "code-review",
+        "qodo",
+        "github",
+        "pull-requests",
+        "automation",
+        "agents"
+      ],
+      "adapters": [
+        "claude",
+        "codex",
+        "cursor",
+        "copilot",
+        "grok",
+        "windsurf",
         "kiro"
       ]
     }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.17.0",
+  "version": "1.19.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()

package/packages/marketing/viral-launch/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:viral-launch",
+  "version": "0.1.0",
+  "description": "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops.",
+  "skills": "skills/"
+}

package/packages/marketing/viral-launch/adapters/grok/skills/viral-launch/SKILL.md

@@ -0,0 +1,105 @@
+---
+
+name: viral-launch
+description: Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops without pretending virality is guaranteed.
+license: MIT
+allowed-tools: Bash, Read, Write, WebSearch, WebFetch
+compatibility: Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.
+metadata:
+  targets: [_source-only]
+  author: Oleg Koval
+  tags:
+    - marketing
+    - launch
+    - growth
+    - virality
+    - positioning
+    - github
+
+---
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+# viral-launch
+
+Use this skill when a user wants to launch a project, make a repo marketable, improve discoverability, or build shareable launch assets.
+
+This skill is opinionated: virality is not a promise. The goal is to make the project easy to understand, easy to share, and easy to act on.
+
+## Trigger phrases
+
+- make this repo launch-ready
+- set this up to go viral
+- prepare a product launch
+- create marketing assets for this project
+- improve the README for launch
+- prepare Product Hunt / Hacker News / X / LinkedIn launch copy
+- set up an open-source repo for growth
+
+## Workflow
+
+1. Inspect the project first:
+  - product purpose
+  - target user
+  - core use case
+  - current README and docs
+  - install or demo path
+  - screenshots, videos, or visual proof
+  - analytics or waitlist capture if present
+2. Define the launch angle in one sentence:
+  - who it is for
+  - what painful job it solves
+  - why now
+  - what makes it different
+3. Make the repo launch-ready:
+  - clear README headline and first paragraph
+  - demo or quickstart within the first screen
+  - installation steps that work from a clean checkout
+  - screenshots, GIF, or demo link where possible
+  - feature list based on outcomes, not implementation trivia
+  - examples for the highest-intent use cases
+  - badges only when they add trust
+  - license, contributing notes, and issue templates when useful
+4. Create launch assets:
+  - short tagline
+  - 1-paragraph announcement
+  - 5 social post variants
+  - Product Hunt tagline and description when relevant
+  - Hacker News title candidates when relevant
+  - launch email or DM when relevant
+  - creator/influencer outreach list criteria, not spam copy
+5. Design share loops:
+  - a reason users would show the output to someone else
+  - a public artifact worth linking
+  - a before/after demo
+  - a template, benchmark, checklist, or gallery that can travel
+  - referral or waitlist loop only if it fits the product
+6. Define proof and metrics:
+  - activation event
+  - share event
+  - conversion event
+  - retention proxy
+  - launch-day dashboard or simple tracking checklist
+7. Keep claims grounded:
+  - do not invent traction, logos, benchmarks, testimonials, or user counts
+  - mark assumptions explicitly
+  - prefer specific proof over hype
+  - avoid dark patterns and spam
+
+## Output format
+
+When planning, produce:
+
+- Launch angle
+- Repo changes
+- Launch assets
+- Share loops
+- Metrics
+- Risks and assumptions
+- Next actions
+
+When editing a repository, make the smallest useful set of changes first, then validate by reading the README from a new user's perspective.
+
+## References
+
+- `references/launch-checklist.md`
+- `references/external-skills.md`

package/packages/music/fill-music-player/adapters/grok/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "olko:fill-music-player",
+  "version": "0.1.0",
+  "description": "Fill a portable music player with a curated random selection from a source music library while balancing formats, artists, albums, and capacity.",
+  "skills": "skills/"
+}