Agent-agnostic skill collection for Codex, Claude, Cursor, Grok, and other skill-aware tools.

These skills are opinionated by design. They encode working defaults, preferred tools, and repeatable workflows instead of trying to be neutral snippets. Treat them as starting points with taste: useful out of the box, easy to inspect, and specific enough for an agent to execute consistently.

Structure

• packages/ — canonical skill packages organized by category
• catalog/ — machine-readable inventory
• collections/ — grouped package bundles
• scripts/ — sync and validation helpers

Principles

• Keep one canonical skill package per workflow.
• Put agent-specific wrappers in adapters/ instead of duplicating the core skill.
• Keep catalogs neutral and machine-readable.
• Add marketplace-specific metadata on top of the canonical package, not instead of it.

Quick Start

Install all package symlinks into your local Codex skills directory:

git clone https://github.com/oleg-koval/agent-skills.git
cd agent-skills
./scripts/install-codex-symlinks.sh

Then mention a lookup name in a new Codex session:

Use the olko:semantic-release-beta skill to add prereleases on a beta branch.

The repository includes a generated Claude marketplace manifest at .claude-plugin/marketplace.json.

For marketplace installs:

/plugin marketplace add oleg-koval/agent-skills

Then install the catalog plugin:

/plugin install olko-agent-skills@olko-agent-skills

For local development:

Clone the repo and point Claude Code at the plugin directory:

git clone https://github.com/oleg-koval/agent-skills.git
claude --plugin-dir /path/to/agent-skills

Grok (xAI) supports plugins via marketplace or direct path. Add this catalog as a marketplace source:

grok plugin marketplace add oleg-koval/agent-skills

Or for local development / direct use:

grok agent --plugin-dir /path/to/agent-skills

Skills are available via their olko:* names or through the installed plugin. Grok discovers plugin.json + skills/ (and falls back to .claude-plugin/ manifests for compatibility).

The repo generates .grok-plugin/index.json for structured plugin discovery.

Copy the relevant SKILL.md or adapter content into .cursor/rules/, or reference the full package directory from your Cursor rules.

Copy .github/copilot-instructions.md to your repository and enable Copilot. It will automatically apply skill guidance.

Copy the relevant .windsurf/rules/{skill-name}.md into your project's .windsurf/rules/ directory. Windsurf picks them up automatically as Cascade Rules.

Copy the relevant .kiro/steering/{skill-name}.md into your project's .kiro/steering/ directory.

Skills are plain Markdown. Use the canonical package file directly:

packages/{category}/{skill}/SKILL.md

All 23 Skills

Each entry links to its SKILL.md. Reference any skill by its olko:* lookup name in a new agent session.

Software development (19)

| Skill | What it does | Use when | |-------|-------------|----------| | add-to-my-skills | 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 | 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 | 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 | 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 | 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 | | crash-course | Expert tutor for rapid, source-grounded learning of any topic: a timed 4-hour sprint plus cheat-sheet, learning-ladder, quiz-me, Feynman, and resource-curation modes | Ramping up on an unfamiliar codebase, project, or concept under time pressure | | docs-index-keeper | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | | product-builder | 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 | Uses promptctl for reusable prompt templates, scoring, and workflow automation | A project needs prompt conventions, review, scoring, or reusable prompt workflows | | review-past-performance | 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 | 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 | 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 | 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 |

Marketing (2)

| Skill | What it does | Use when | |-------|-------------|----------| | search-console-indexing-audit | 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 | 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 |

Music (1)

| Skill | What it does | Use when | |-------|-------------|----------| | fill-music-player | 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 (1)

| Skill | What it does | Use when | |-------|-------------|----------| | gallery | Creates photo galleries with AI-assisted layout curation and sequencing | Building a gallery from photos or planning photo layout, sequencing, and curation |

How to use skills

Install the Codex symlinks, then mention a skill by its lookup name in a new agent session:

./scripts/install-codex-symlinks.sh

Use the olko:semantic-release-beta skill to add prereleases on a beta branch.

Use the olko:gallery skill to build a photo gallery from this image folder.

Use the olko:add-to-my-skills skill to copy a skill from another repo into this catalog, update the README, and push the change.

Use the olko:viral-launch skill to make this project launch-ready.

Each package has a canonical SKILL.md under packages/{category}/{skill}/. Agent-specific wrappers live under that package's adapters/ directory.

When adding or changing a skill:

1. Update the canonical SKILL.md first.
2. Keep instructions concrete and operational.
3. Add references only when the agent needs extra detail to execute the workflow.
4. Update catalog/skills.json if the skill name, category, description, path, tags, or adapters change.
5. Run local validation before publishing changes.

Root manifests

| 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 | | Grok | .grok-plugin/index.json | Plugin index (plus .claude-plugin/ compatibility) | | GitHub Copilot | .github/copilot-instructions.md | Repository instructions | | GitHub Copilot | .github/prompts/*.prompt.md | Per-skill prompt files | | Windsurf | .windsurf/rules/*.md | Cascade rules | | Kiro | .kiro/steering/*.md | Steering documents |

All root manifests are generated from catalog/skills.json by ./scripts/build-adapters.sh.

How Skills Work

Every package follows a consistent anatomy:

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/
    ├── claude/
    ├── cursor/
    ├── grok/
    ├── 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: agent-specific wrappers wrap the canonical package instead of forking it.

See docs/skill-anatomy.md for the package format.

Project Structure

agent-skills/
├── 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/

Local validation

Rebuild generated manifests:

./scripts/build-adapters.sh

Validate the neutral catalog and generated root manifests:

./scripts/validate-catalog.sh

Run both before pushing marketplace updates:

./scripts/build-adapters.sh && ./scripts/validate-catalog.sh