@olegkoval/agent-skills 1.6.0 → 1.7.0

package/README.md

@@ -1,10 +1,10 @@
 <div align="center">
   <h1>agent skills</h1>
-  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, and other skill-aware tools.</strong></p>
+  <p><strong>Agent-agnostic skill catalog for Codex, Claude, Cursor, 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-12-2563eb" alt="12 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/skills-16-2563eb" alt="16 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/status-public%20catalog-16a34a" alt="Public catalog">
   </p>
 </div>
@@ -117,6 +117,46 @@ See [Publishing to Marketplaces](#publishing-to-marketplaces) for integration de
 
 </details>
 
+<details>
+<summary><b>Windsurf</b></summary>
+
+The repository includes generated Windsurf Cascade Rules at `.windsurf/rules/`.
+
+**For a single project:**
+
+Copy the relevant `.windsurf/rules/{skill-name}.md` into your project's `.windsurf/rules/` directory. Windsurf picks them up automatically as Cascade Rules.
+
+**For all skills at once:**
+
+```bash
+git clone https://github.com/oleg-koval/agent-skills.git
+cp agent-skills/.windsurf/rules/*.md /path/to/your/project/.windsurf/rules/
+```
+
+Each rule file has a `description` frontmatter field that Windsurf displays in the rules panel.
+
+</details>
+
+<details>
+<summary><b>Kiro</b></summary>
+
+The repository includes generated Kiro steering documents at `.kiro/steering/`.
+
+**For a single project:**
+
+Copy the relevant `.kiro/steering/{skill-name}.md` into your project's `.kiro/steering/` directory.
+
+**For all skills at once:**
+
+```bash
+git clone https://github.com/oleg-koval/agent-skills.git
+cp agent-skills/.kiro/steering/*.md /path/to/your/project/.kiro/steering/
+```
+
+Each steering doc uses `inclusion: manual` so Kiro only loads it when you explicitly reference it, keeping context lean.
+
+</details>
+
 <details>
 <summary><b>Other agents</b></summary>
 
@@ -134,7 +174,7 @@ packages/{category}/{skill}/adapters/
 
 </details>
 
-## All 12 Skills
+## All 16 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.
 
@@ -150,6 +190,10 @@ These packages are the entry points. Each one is a structured workflow with conc
 | [add-to-my-skills](packages/software-development/add-to-my-skills/SKILL.md) | Copies a skill from another repo into this catalog, then refreshes docs, manifests, commit, and push | Bringing a newly created skill into this repository |
 | [promptctl](packages/software-development/promptctl/SKILL.md) | Uses `promptctl` for reusable prompt templates, scoring, and workflow automation | A project needs prompt conventions, prompt review, prompt scoring, or reusable prompt workflows |
 | [product-builder](packages/software-development/product-builder/SKILL.md) | Builds a full-stack web app or SaaS product from a user description using production-oriented defaults | The user asks to build a complete app, SaaS, dashboard, or product rather than a prototype |
+| [cloudflare-block-countries](packages/software-development/cloudflare-block-countries/SKILL.md) | Blocks specific countries via Cloudflare WAF Custom Rules using the API | Geo-blocking traffic, setting up WAF country rules, or blocking regions across single or multiple zones |
+| [ai-tools-setup](packages/software-development/ai-tools-setup/SKILL.md) | Installs, repairs, and measures the RTK+ICM+Vox AI development toolkit | Setting up or repairing AI dev tooling hooks, MCP config, or reviewing a weekly token savings digest |
+| [starter-rules](packages/software-development/starter-rules/SKILL.md) | Loads and enforces hard rules for every oleg-koval/* starter | Ensuring 300-line files, E2E tests, pre-commit hooks, Vertical Slice architecture, and KISS/DRY/SOLID |
+| [open-source-publisher](packages/software-development/open-source-publisher/SKILL.md) | Prepares an open-source repository for public publishing with branding, CI/CD, and release hygiene | Releasing a private project publicly with proper GitHub Pages, README, and social preview |
 
 ### Music
 
@@ -206,12 +250,17 @@ When adding or changing a skill:
 
 ## Root manifests
 
-- Claude marketplace manifest: `.claude-plugin/marketplace.json`
-- Cursor plugin index: `.cursor-plugin/index.json`
-- Copilot repository instructions: `.github/copilot-instructions.md`
-- Copilot prompt files: `.github/prompts/*.prompt.md`
+| Harness | File | Format |
+|---------|------|--------|
+| Claude Code | `.claude-plugin/marketplace.json` | Marketplace plugin registry |
+| Claude Code | `.claude-plugin/plugin.json` | Plugin manifest |
+| Cursor | `.cursor-plugin/index.json` | Plugin index |
+| GitHub Copilot | `.github/copilot-instructions.md` | Repository instructions |
+| GitHub Copilot | `.github/prompts/*.prompt.md` | Per-skill prompt files |
+| Windsurf | `.windsurf/rules/*.md` | Cascade rules |
+| Kiro | `.kiro/steering/*.md` | Steering documents |
 
-These are generated from the neutral package inventory and kept in the repo for platform-specific consumption.
+All root manifests are generated from `catalog/skills.json` by `./scripts/build-adapters.sh`.
 
 ## How Skills Work
 
@@ -221,17 +270,19 @@ Every package follows a consistent anatomy:
 packages/{category}/{skill}/
 ├── SKILL.md              # Required canonical skill definition
 ├── references/           # Optional supporting material loaded only when needed
-└── adapters/             # Optional agent-specific wrappers
-    ├── codex/
-    ├── claude/
-    └── cursor/
+└── adapters/             # Agent-specific wrappers (all generated by build-adapters.sh)
+    ├── codex/            # OpenAI Codex — README.md stub
+    ├── claude/           # Claude Code — plugin.json + skills/SKILL.md copy
+    ├── cursor/           # Cursor — plugin.json + skills/SKILL.md copy
+    ├── windsurf/         # Windsurf — rules/{name}.md (Cascade Rules format)
+    └── kiro/             # Amazon Kiro — steering/{name}.md (steering doc format)
 ```
 
 Key design choices:
 
 - Process over prose: skills are workflows agents follow, not generic reference essays.
 - Progressive disclosure: `SKILL.md` is the entry point; supporting files load only when needed.
-- Adapter separation: Codex, Claude, Cursor, and Copilot metadata wrap the canonical package instead of forking it.
+- Adapter separation: Codex, Claude, Cursor, Copilot, Windsurf, and Kiro metadata wrap the canonical package instead of forking it.
 - Verifiable changes: catalog and manifest changes should pass `./scripts/validate-catalog.sh`.
 
 See [docs/skill-anatomy.md](docs/skill-anatomy.md) for the package format.
@@ -262,6 +313,8 @@ agent-skills/
 ├── .claude-plugin/                   # Generated Claude marketplace manifest
 ├── .cursor-plugin/                   # Generated Cursor plugin index
 ├── .github/prompts/                  # Generated GitHub Copilot prompt files
+├── .windsurf/rules/                  # Generated Windsurf Cascade Rules
+├── .kiro/steering/                   # Generated Kiro steering documents
 └── docs/                             # Contributor and package format docs
 ```
 

package/catalog/skills.json

@@ -18,7 +18,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -39,7 +41,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -58,7 +62,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -78,7 +84,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -96,7 +104,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -115,7 +125,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -134,7 +146,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -154,7 +168,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -174,7 +190,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -197,7 +215,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -217,7 +237,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -239,7 +261,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -262,7 +286,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -283,7 +309,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -304,7 +332,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     },
     {
@@ -324,7 +354,9 @@
         "codex",
         "claude",
         "cursor",
-        "copilot"
+        "copilot",
+        "windsurf",
+        "kiro"
       ]
     }
   ]

package/docs/skill-anatomy.md

@@ -133,12 +133,16 @@ Adapters are wrappers for agent-specific packaging. They should point back to th
 
 Current adapter targets:
 
-- `adapters/codex/`
-- `adapters/claude/`
-- `adapters/cursor/`
-- generated GitHub Copilot prompt files in `.github/prompts/`
-
-Claude plugin and marketplace identifiers must be kebab-case. Keep `olko:*` names for Codex lookup names, but do not use colons or spaces in Claude marketplace/plugin names.
+| Adapter | Generated files | Root output |
+|---------|----------------|-------------|
+| `codex` | `adapters/codex/README.md` (static stub) | — |
+| `claude` | `adapters/claude/plugin.json` + `adapters/claude/skills/{name}/SKILL.md` | `.claude-plugin/` |
+| `cursor` | `adapters/cursor/plugin.json` + `adapters/cursor/skills/{name}/SKILL.md` | `.cursor-plugin/index.json` |
+| `copilot` | — | `.github/prompts/{name}.prompt.md` |
+| `windsurf` | `adapters/windsurf/rules/{name}.md` | `.windsurf/rules/{name}.md` |
+| `kiro` | `adapters/kiro/steering/{name}.md` | `.kiro/steering/{name}.md` |
+
+Claude plugin and marketplace identifiers must be kebab-case. Keep `olko:*` names for Codex and Cursor lookup names, but do not use colons or spaces in Claude marketplace/plugin names.
 
 After changing a package name, description, category, path, tags, or adapter support, update `catalog/skills.json` and rebuild generated files:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olegkoval/agent-skills",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -25,6 +25,8 @@
     "packages",
     ".claude-plugin",
     ".cursor-plugin",
+    ".windsurf",
+    ".kiro",
     "scripts",
     "README.md",
     "LICENSE"

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

@@ -2,6 +2,9 @@
 
 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, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools.
 metadata:
   author: Oleg Koval
   tags:

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

@@ -4,6 +4,9 @@
 
 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, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools.
 metadata:
   author: Oleg Koval
   tags:

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

@@ -1,6 +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.",
+  "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/cursor/skills/search-console-indexing-audit/SKILL.md

@@ -4,6 +4,9 @@
 
 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, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools.
 metadata:
   author: Oleg Koval
   tags:

package/packages/marketing/search-console-indexing-audit/adapters/kiro/steering/search-console-indexing-audit.md

@@ -0,0 +1,57 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+inclusion: manual
+description: "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
+---
+
+
+# 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/windsurf/rules/search-console-indexing-audit.md

@@ -0,0 +1,56 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+description: "Analyze Google Search Console Coverage CSV exports and correlate them with sitemap, robots, canonical, redirect, and noindex signals."
+---
+
+
+# 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/viral-launch/SKILL.md

@@ -2,7 +2,9 @@
 
 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.
-compatibility: Codex, Claude Code, Cursor, GitHub Copilot, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.
+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:
   author: Oleg Koval
   tags:

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

@@ -4,7 +4,9 @@
 
 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.
-compatibility: Codex, Claude Code, Cursor, GitHub Copilot, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.
+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:
   author: Oleg Koval
   tags:

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

@@ -4,7 +4,9 @@
 
 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.
-compatibility: Codex, Claude Code, Cursor, GitHub Copilot, and other Agent Skills compatible tools. Useful for product repos, open-source packages, SaaS launches, waitlists, and creator tools.
+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:
   author: Oleg Koval
   tags:

package/packages/marketing/viral-launch/adapters/kiro/steering/viral-launch.md

@@ -0,0 +1,92 @@
+<!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
+
+---
+inclusion: manual
+description: "Set up a project repository and launch plan for shareable marketing, public launch readiness, and growth loops."
+---
+
+
+# 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`