@olegkoval/agent-skills 1.14.0 → 1.15.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.13.0",
+  "version": "1.14.1",
   "author": {
     "name": "Oleg Koval"
   },
@@ -9,6 +9,7 @@
   "repository": "https://github.com/oleg-koval/agent-skills",
   "license": "MIT",
   "skills": [
+    "./packages/software-development/self-critique",
     "./packages/software-development/docs-index-keeper",
     "./packages/software-development/semantic-release-beta",
     "./packages/software-development/gh-cli",

package/.cursor-plugin/index.json

@@ -1,6 +1,11 @@
 {
   "name": "agent-skills",
   "plugins": [
+    {
+      "name": "olko:self-critique",
+      "source": "./packages/software-development/self-critique/adapters/cursor",
+      "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/cursor",
@@ -59,7 +64,7 @@
     {
       "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."
+      "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",

package/.kiro/steering/open-source-publisher.md

@@ -2,7 +2,7 @@
 
 ---
 inclusion: manual
-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."
+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."
 ---
 
 # open-source-publisher
@@ -30,10 +30,12 @@ Use this skill to audit whether an OSS repository is ready to publish, then help
 5. For existing usable pieces, do not propose replacement by default. Ask a change-oriented question only when useful, for example:
    - "You already have a terminal-style GitHub Pages site. Do you want to keep it or restyle it?"
    - "You already have an icon and social card. Do you want a refresh, or should I leave them as-is?"
+   - "You already have a static social card. Do you want me to animate it with pixel2motion, or leave it static?"
    - "You already have release automation. Do you want me to audit only, or also tighten it?"
 6. Ask only for choices needed to fix missing or weak pieces:
    - If GitHub Pages is missing or weak, ask for style: `oldschool linux`, `terminal`, `modern`, `brutalist`, `glassmorphism`, `y2k`, `hacker`, or custom.
    - If donation wiring is missing, ask whether to enable it: `none`, `GitHub Sponsors`, `Ko-fi`, `Buy Me a Coffee`, `Open Collective`, `Thanks.dev`, or custom URL.
+   - If the repo has a generated static social image or hero card, ask whether to animate it using `nolangz/pixel2motion`.
    - If the repo has no clear product essence, ask for a one-sentence positioning statement.
 7. Implement only approved, missing, or weak work in this order:
    - OSS governance and support files
@@ -193,6 +195,14 @@ file social-card.png
 
 Use `magick` or another renderer when `rsvg-convert` is unavailable.
 
+## Motion Preview
+
+Some repos benefit from a short animated preview. Keep this opt-in.
+
+- If you already generated a static image, ask: `Do you want me to animate the static image using pixel2motion?`
+- If the user says yes, use `nolangz/pixel2motion` as the optional dependency for logo animation, animated HTML demos, and GIF/video previews.
+- Do not auto-animate by default.
+
 ## README Standard
 
 Shape the README like the house standard used for Go packages such as `slow-query-detector` and `dcli`.

package/.windsurf/rules/open-source-publisher.md

@@ -1,7 +1,7 @@
 <!-- Generated by scripts/build-adapters.sh. Do not edit directly. -->
 
 ---
-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."
+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."
 ---
 
 # open-source-publisher
@@ -29,10 +29,12 @@ Use this skill to audit whether an OSS repository is ready to publish, then help
 5. For existing usable pieces, do not propose replacement by default. Ask a change-oriented question only when useful, for example:
    - "You already have a terminal-style GitHub Pages site. Do you want to keep it or restyle it?"
    - "You already have an icon and social card. Do you want a refresh, or should I leave them as-is?"
+   - "You already have a static social card. Do you want me to animate it with pixel2motion, or leave it static?"
    - "You already have release automation. Do you want me to audit only, or also tighten it?"
 6. Ask only for choices needed to fix missing or weak pieces:
    - If GitHub Pages is missing or weak, ask for style: `oldschool linux`, `terminal`, `modern`, `brutalist`, `glassmorphism`, `y2k`, `hacker`, or custom.
    - If donation wiring is missing, ask whether to enable it: `none`, `GitHub Sponsors`, `Ko-fi`, `Buy Me a Coffee`, `Open Collective`, `Thanks.dev`, or custom URL.
+   - If the repo has a generated static social image or hero card, ask whether to animate it using `nolangz/pixel2motion`.
    - If the repo has no clear product essence, ask for a one-sentence positioning statement.
 7. Implement only approved, missing, or weak work in this order:
    - OSS governance and support files
@@ -192,6 +194,14 @@ file social-card.png
 
 Use `magick` or another renderer when `rsvg-convert` is unavailable.
 
+## Motion Preview
+
+Some repos benefit from a short animated preview. Keep this opt-in.
+
+- If you already generated a static image, ask: `Do you want me to animate the static image using pixel2motion?`
+- If the user says yes, use `nolangz/pixel2motion` as the optional dependency for logo animation, animated HTML demos, and GIF/video previews.
+- Do not auto-animate by default.
+
 ## README Standard
 
 Shape the README like the house standard used for Go packages such as `slow-query-detector` and `dcli`.

package/README.md

@@ -3,7 +3,7 @@
   <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-19-2563eb" alt="19 skills">
+    <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/status-public%20catalog-16a34a" alt="Public catalog">
   </p>
@@ -11,8 +11,6 @@
 
 Agent-agnostic skill collection for Codex, Claude, Cursor, and other skill-aware tools.
 
-Pi and Hermes adapters currently exist for `search-console-indexing-audit` only.
-
 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.
 
 ## Structure
@@ -76,87 +74,34 @@ git clone https://github.com/oleg-koval/agent-skills.git
 claude --plugin-dir /path/to/agent-skills
 ```
 
-See [Publishing to Marketplaces](#publishing-to-marketplaces) below for full submission details.
-
 </details>
 
 <details>
 <summary><b>Cursor</b></summary>
 
-The repository includes a generated Cursor plugin index at `.cursor-plugin/index.json` and per-package Cursor adapters under `packages/*/*/adapters/cursor/`.
-
-**For plugin marketplace:**
-
-Install from Cursor's extension marketplace using the published repository.
-
-**For a single project:**
-
 Copy the relevant `SKILL.md` or adapter content into `.cursor/rules/`, or reference the full package directory from your Cursor rules.
 
-See [Publishing to Marketplaces](#publishing-to-marketplaces) for registry submission.
-
 </details>
 
 <details>
 <summary><b>GitHub Copilot</b></summary>
 
-Use the generated repository instructions and prompt files:
-
-```text
-.github/copilot-instructions.md
-.github/prompts/*.prompt.md
-```
-
-**To use in your GitHub workspace:**
-
 Copy `.github/copilot-instructions.md` to your repository and enable Copilot. It will automatically apply skill guidance.
 
-**To customize per-skill:**
-
-Use files from `.github/prompts/*.prompt.md` in your Copilot configuration.
-
-See [Publishing to Marketplaces](#publishing-to-marketplaces) for integration details.
-
 </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>
@@ -168,51 +113,52 @@ Skills are plain Markdown. Use the canonical package file directly:
 packages/{category}/{skill}/SKILL.md
 ```
 
-Agent-specific wrappers live under:
-
-```text
-packages/{category}/{skill}/adapters/
-```
-
 </details>
 
-## All 19 Skills
+## All 23 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.
+Each entry links to its `SKILL.md`. Reference any skill by its `olko:*` lookup name in a new agent session.
 
-### Software development
+### Software development (19)
 
-| Skill | What It Does | Use When |
+| Skill | What it does | Use when |
 |-------|-------------|----------|
-| [docs-index-keeper](packages/software-development/docs-index-keeper/SKILL.md) | Keeps a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows | A repo has `docs/` and needs `docs/README.md` or another Markdown index updated automatically |
-| [semantic-release-beta](packages/software-development/semantic-release-beta/SKILL.md) | Sets up `semantic-release-npm-github-publish` with stable `main` releases and beta prereleases | A Node package needs stable npm publishing plus beta prereleases from a `beta` branch |
-| [gh-cli](packages/software-development/gh-cli/SKILL.md) | Guides GitHub CLI usage for repos, PRs, Actions, releases, issues, and related GitHub operations | Working with GitHub from the command line and needing reliable `gh` commands |
-| [git-commit](packages/software-development/git-commit/SKILL.md) | Creates conventional commits with diff-aware staging and message generation | The user asks to commit changes or wants a conventional commit message from the current diff |
-| [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 |
-| [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 |
+| [add-to-my-skills](packages/software-development/add-to-my-skills/SKILL.md) | Copies a newly created skill from another repo into this catalog, refreshes the README and generated manifests, then commits and pushes | Adding a skill you wrote elsewhere into this catalog |
+| [ai-tools-setup](packages/software-development/ai-tools-setup/SKILL.md) | Sets up, repairs, and reports on the RTK + ICM + Vox AI development toolkit — installs missing tools, fixes broken hooks and MCP config | Bootstrapping AI dev tools on a new machine or diagnosing broken integrations |
+| [apple-store-submit](packages/software-development/apple-store-submit/SKILL.md) | Handles App Store rejection emails end-to-end — parses rejection reasons, creates a fix plan, implements code changes, and prepares resubmission | Responding to App Store rejections for privacy strings, entitlements, or guideline violations |
+| [changelog-generator](packages/software-development/changelog-generator/SKILL.md) | Transforms git commits into polished user-facing changelogs by categorising changes and rewriting technical commit messages | Preparing release notes, app store update descriptions, or a public changelog |
+| [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 or setting up WAF country rules across single or multiple zones |
+| [docs-index-keeper](packages/software-development/docs-index-keeper/SKILL.md) | Keeps a Markdown docs index in sync through pre-commit, CI, or one-off maintenance flows | A repo has `docs/` and needs `docs/README.md` updated automatically |
+| [gh-cli](packages/software-development/gh-cli/SKILL.md) | Guides GitHub CLI usage for repos, PRs, Actions, releases, issues, and all related GitHub operations | Working with GitHub from the command line and needing reliable `gh` commands |
+| [git-commit](packages/software-development/git-commit/SKILL.md) | Creates conventional commits with diff-aware staging and message generation | Asking to commit changes or wanting a conventional commit message from the current diff |
+| [macos-menubar-app](packages/software-development/macos-menubar-app/SKILL.md) | Builds a production-quality macOS menubar or notch app in SwiftUI — MenuBarExtra setup, sandbox entitlements, keyboard shortcuts, sound effects | Building a native macOS utility that lives in the menu bar or Dynamic Island notch |
+| [mvp-oneshot](packages/software-development/mvp-oneshot/SKILL.md) | Takes a rough product idea and produces a scoped, testable MVP plan and initial implementation in a single pass | Going from idea to a shippable one-week MVP without losing scope |
+| [obsidian-pr-sync](packages/software-development/obsidian-pr-sync/SKILL.md) | Fetches open GitHub PRs assigned to you or requesting review and writes a grouped age-sorted section into today's Obsidian daily note | Syncing GitHub review queue to Obsidian at the start of the day or on demand |
+| [obsidian-task-rollover](packages/software-development/obsidian-task-rollover/SKILL.md) | Migrates unchecked tasks from today's Obsidian daily note to the next workday under `## Carried over` | End-of-day bullet-journal task migration |
 | [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 |
-| [obsidian-pr-sync](packages/software-development/obsidian-pr-sync/SKILL.md) | Fetches open GitHub PRs assigned to you or requesting review, and writes a grouped age-sorted section into today's Obsidian daily note | Syncing GitHub review queue to Obsidian at the start of the day or on demand |
-| [obsidian-task-rollover](packages/software-development/obsidian-task-rollover/SKILL.md) | Migrates unchecked tasks from today's Obsidian daily note to the next workday under `## Carried over`, marking source tasks as `[>]` | End-of-day bullet-journal task migration, rolling unfinished work to the next workday |
-| [review-past-performance](packages/software-development/review-past-performance/SKILL.md) | Self-improvement loop: pulls 24h of ICM memories, git history, and skill analytics; detects repeated mistakes, slow workflows, and missing coverage; proposes 1-3 concrete fixes | Reviewing a day's coding sessions for patterns, wanting to codify a repeated workflow, or running a daily self-improvement loop |
+| [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 | Building a complete app, SaaS, dashboard, or product rather than a prototype |
+| [promptctl](packages/software-development/promptctl/SKILL.md) | Uses `promptctl` for reusable prompt templates, scoring, and workflow automation | A project needs prompt conventions, review, scoring, or reusable prompt workflows |
+| [review-past-performance](packages/software-development/review-past-performance/SKILL.md) | Pulls 24h of ICM memories, git history, and skill analytics; detects repeated mistakes and slow workflows; proposes 1-3 concrete fixes | Daily self-improvement loop or codifying a repeated workflow |
+| [semantic-release-beta](packages/software-development/semantic-release-beta/SKILL.md) | Sets up `semantic-release` with stable `main` releases and beta prereleases on a `beta` branch | A Node package needs stable npm publishing plus beta prereleases |
+| [skill-budget-audit](packages/software-development/skill-budget-audit/SKILL.md) | Diagnoses and fixes Claude Code's skill context budget overflow — identifies heavy plugin bundles that exceed the 2% budget | Skills failing to load or Claude hitting context limits from plugin bundles |
+| [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 |
 
-### Music
+### Marketing (2)
 
-| Skill | What It Does | Use When |
+| Skill | What it does | Use when |
 |-------|-------------|----------|
-| [fill-music-player](packages/music/fill-music-player/SKILL.md) | Fills a portable music player with a curated random music selection while balancing formats, artists, albums, and capacity | Copying music from a NAS or local library to a Walkman, iPod, USB drive, or similar device |
+| [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 |
+| [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, or creator tool for public launch |
 
-### Marketing
+### Music (1)
 
-| Skill | What It Does | Use When |
+| 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 |
+| [fill-music-player](packages/music/fill-music-player/SKILL.md) | Fills a portable music player with a curated random selection while balancing formats, artists, albums, and capacity | Copying music from a NAS or local library to a Walkman, iPod, USB drive, or similar device |
 
-### Photography
+### Photography (1)
 
-| Skill | What It Does | Use When |
+| Skill | What it does | Use when |
 |-------|-------------|----------|
 | [gallery](packages/photography/gallery/SKILL.md) | Creates photo galleries with AI-assisted layout curation and sequencing | Building a gallery from photos or planning photo layout, sequencing, and curation |
 
@@ -273,21 +219,18 @@ packages/{category}/{skill}/
 ├── SKILL.md              # Required canonical skill definition
 ├── references/           # Optional supporting material loaded only when needed
 └── 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
-    ├── pi/               # Pi — README.md stub, where supported
-    ├── hermes/           # Hermes — README.md stub, where supported
-    ├── windsurf/         # Windsurf — rules/{name}.md (Cascade Rules format)
-    └── kiro/             # Amazon Kiro — steering/{name}.md (steering doc format)
+    ├── codex/
+    ├── claude/
+    ├── cursor/
+    ├── windsurf/
+    └── kiro/
 ```
 
 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, Copilot, Windsurf, Kiro, and any package-specific adapters wrap the canonical package instead of forking it.
-- Verifiable changes: catalog and manifest changes should pass `./scripts/validate-catalog.sh`.
+- Adapter separation: agent-specific wrappers wrap the canonical package instead of forking it.
 
 See [docs/skill-anatomy.md](docs/skill-anatomy.md) for the package format.
 
@@ -295,166 +238,21 @@ See [docs/skill-anatomy.md](docs/skill-anatomy.md) for the package format.
 
 ```text
 agent-skills/
-├── packages/                         # Canonical skill packages
-│   ├── software-development/
-│   │   ├── docs-index-keeper/
-│   │   ├── semantic-release-beta/
-│   │   ├── gh-cli/
-│   │   ├── git-commit/
-│   │   ├── promptctl/
-│   │   └── product-builder/
-│   ├── music/
-│   │   └── fill-music-player/
-│   ├── marketing/
-│   │   └── viral-launch/
-│   └── photography/
-│       └── gallery/
-├── catalog/                          # Machine-readable package inventory
-├── collections/                      # Grouped package bundles
-├── scripts/                          # Build, validation, sync, and install helpers
-├── .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
-```
-
-## Install and test
-
-### Codex
-
-Install all canonical packages into your local Codex skills directory:
-
-```bash
-./scripts/install-codex-symlinks.sh
-```
-
-This creates symlinks from the package catalog into `${CODEX_HOME:-~/.codex}/skills` using the lookup format `olko:{skill_name}`.
-
-To test a skill in a fresh Codex session, mention it explicitly:
-
-```text
-Use the olko:docs-index-keeper skill to set up docs index automation in this repo.
-```
-
-```text
-Use the olko:semantic-release-beta skill to add prereleases on a beta branch.
-```
-
-Status: **Stable** — ready for daily use
-
-### Claude Code
-
-The repository includes a generated marketplace manifest at `.claude-plugin/marketplace.json` and per-package Claude adapter stubs under `packages/*/*/adapters/claude/`.
-
-**Local development:**
-
-```bash
-git clone https://github.com/oleg-koval/agent-skills.git
-claude --plugin-dir /path/to/agent-skills
-```
-
-**Marketplace installation:**
-
-See [Publishing to Marketplaces → Claude Marketplace](#claude-marketplace) for submission and user installation instructions.
-
-Status: **Ready for marketplace** — fully generated manifests, ready to publish
-
-### Cursor
-
-The repository includes a generated plugin index at `.cursor-plugin/index.json` and per-package Cursor adapter stubs under `packages/*/*/adapters/cursor/`.
-
-See [Publishing to Marketplaces → Cursor Plugin Registry](#cursor-plugin-registry) for submission instructions.
-
-Status: **Ready for marketplace** — plugin index generated and ready to submit
-
-### GitHub Copilot
-
-The repository includes generated repository instructions at `.github/copilot-instructions.md` and per-skill prompt files under `.github/prompts/`.
-
-To use in your GitHub workspace, copy `.github/copilot-instructions.md` to your repository.
-
-See [Publishing to Marketplaces → GitHub Copilot](#github-copilot) for integration details.
-
-Status: **Ready to use** — copy instructions to any GitHub repository
-
-### Source sync
-
-`./scripts/sync-from-sources.sh` syncs package content only for catalog entries that explicitly define `sourcePath`. If no package has `sourcePath`, the script exits successfully and reports that there is nothing to sync.
-
-## Publishing to Marketplaces
-
-### Claude Marketplace
-
-The repository includes a generated marketplace manifest at `.claude-plugin/marketplace.json` that is compatible with Claude Code's plugin system.
-
-**To submit to Claude marketplace:**
-
-1. Ensure the repository is public and contains this structure:
-   ```
-   ├── .claude-plugin/
-   │   └── marketplace.json    # Generated from catalog/skills.json
-   └── packages/
-       └── {category}/{skill}/
-           ├── SKILL.md        # Required canonical definition
-           └── adapters/
-               └── claude/     # Optional Claude-specific wrapper
-   ```
-
-2. Push to GitHub with a public repository:
-   ```bash
-   git push origin main
-   ```
-
-3. Submit the repository URL to Claude's plugin marketplace:
-   - In Claude Code: `/plugin marketplace add oleg-koval/agent-skills`
-   - Or visit the Claude plugin marketplace and add `https://github.com/oleg-koval/agent-skills`
-
-4. The marketplace will:
-   - Read `.claude-plugin/marketplace.json` for plugin metadata
-   - Index all skills from `catalog/skills.json`
-   - Auto-register skills by their `name` field
-   - Use `adapters: ["claude"]` entries to provide Claude-specific hints
-
-**After publishing:**
-- Users install with: `/plugin install olko-agent-skills@olko-agent-skills`
-- All 12 skills become available as `olko:*` lookup names in Claude Code
-
-### Cursor Plugin Registry
-
-Cursor plugin index is generated at `.cursor-plugin/index.json`.
-
-**To submit to Cursor:**
-
-1. Ensure Cursor plugin metadata is present:
-   - `.cursor-plugin/index.json` (generated)
-   - `packages/*/*/adapters/cursor/` (optional Cursor-specific guidance)
-
-2. Submit the repository to Cursor's plugin marketplace with the `.cursor-plugin/` manifest
-
-3. Users install from Cursor's extension marketplace and reference skills by lookup name
-
-### GitHub Copilot
-
-Generated Copilot instructions are at `.github/copilot-instructions.md` and per-skill prompts under `.github/prompts/`.
-
-**To use in a GitHub workspace:**
-
-1. Copy `.github/copilot-instructions.md` to your repository
-2. Copilot reads this file automatically when enabled
-3. Per-skill prompts can be referenced or imported into custom Copilot configurations
-
-### Codex
-
-Codex installation uses symlinks:
-
-```bash
-./scripts/install-codex-symlinks.sh
+├── packages/
+│   ├── software-development/   (19 skills)
+│   ├── marketing/              (2 skills)
+│   ├── music/                  (1 skill)
+│   └── photography/            (1 skill)
+├── catalog/
+├── collections/
+├── scripts/
+├── .claude-plugin/
+├── .cursor-plugin/
+├── .github/prompts/
+├── .windsurf/rules/
+└── .kiro/steering/
 ```
 
-Codex looks up skills by `olko:*` lookup names from the installed symlink directories.
-
 ## Local validation
 
 Rebuild generated manifests:
@@ -474,25 +272,3 @@ Run both before pushing marketplace updates:
 ```bash
 ./scripts/build-adapters.sh && ./scripts/validate-catalog.sh
 ```
-
-## Smoke-tested workflows
-
-The following package workflows have been smoke-tested locally before first push:
-
-- `docs-index-keeper`
-  - installed from npm in a temporary git repo
-  - initialized hook generation with `npx docs-index-keeper init`
-  - updated `docs/README.md` from a staged Markdown file
-  - passed `docs-index-keeper check`
-- `semantic-release-beta`
-  - configured a temporary git repo with `main` and `beta` branches
-  - used `semantic-release-npm-github-publish` as the release preset
-  - ran `semantic-release --dry-run --no-ci` on `beta`
-  - verified prerelease calculation to `1.0.0-beta.1`
-
-The semantic-release smoke test was intentionally self-contained and used a local bare git remote plus a valid `file://` repository URL so dry-run behavior could be validated without real npm or GitHub publishing credentials.
-
-## Licensing notes
-
-- `fill-music-player` includes an MIT license and is safe to carry as-is in this repository.
-- `product-builder` now has an MIT license file added in the source repo clone and in this catalog package, matching the existing MIT claim in its README.

package/catalog/skills.json

@@ -1,6 +1,27 @@
 {
   "name": "agent-skills",
   "packages": [
+    {
+      "name": "self-critique",
+      "lookupName": "olko:self-critique",
+      "category": "software-development",
+      "path": "packages/software-development/self-critique",
+      "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.",
+      "tags": [
+        "critical-thinking",
+        "self-review",
+        "verification",
+        "adversarial",
+        "agents",
+        "quality"
+      ],
+      "adapters": [
+        "codex",
+        "claude",
+        "cursor",
+        "copilot"
+      ]
+    },
     {
       "name": "docs-index-keeper",
       "lookupName": "olko:docs-index-keeper",
@@ -250,7 +271,7 @@
       "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.",
+      "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.",
       "tags": [
         "open-source",
         "github",

package/collections/software-development.json

@@ -2,6 +2,7 @@
   "name": "software-development",
   "description": "Skills for software development, release automation, git workflows, documentation, prompt tooling, and product building.",
   "packages": [
+    "self-critique",
     "docs-index-keeper",
     "semantic-release-beta",
     "gh-cli",

package/package.json

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