OK Skills: AI Coding Agent Skills for Codex, Claude Code, Cursor, OpenClaw, and More

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Español | Tiếng Việt | Русский | हिन्दी

Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, Trae, and other SKILL.md-compatible tools.

This repo currently bundles 38 reusable skills: 30 top-level skills maintained directly in this repo, plus 8 vendored GSAP animation skills under gsap-skills/. Clone it into ~/.agents/skills/ok-skills; the directories inside already match the layout expected by AGENTS.md-driven workflows.

If you are looking for Codex skills, Claude Code skills, Cursor skills, OpenClaw skills, reusable AGENTS.md playbooks, or practical SKILL.md examples, this repository is designed to be both searchable and immediately usable.

Popular use cases: docs lookup, browser automation, GitHub Actions debugging, prompt engineering, planning workflows, frontend design, PDF/Word/PPTX/XLSX authoring.

Who This Repo Is For

• You use Codex, Claude Code, Cursor, OpenClaw, Trae, or another AI coding agent and want reusable skills instead of ad-hoc prompts.
• You maintain AGENTS.md / SKILL.md workflows and want portable instructions that work across projects.
• You need battle-tested skills for docs lookup, browser automation, GitHub workflow, planning, prompt engineering, frontend design, PDFs, Office documents, slide decks, and spreadsheets.

Start Here

If you only install a few skills first, start with these:

• brainstorming: explore ideas, requirements, and design before implementation begins.
• planning-with-files: file-based planning for complex tasks, research, and long-running work.
• find-docs: fetch current library docs, API references, and Context7-backed examples.
• agent-browser: browser automation for screenshots, forms, scraping, and web QA.
• gh-fix-ci: inspect failing GitHub Actions checks and turn logs into a fix plan.

1-Minute Quick Start

mkdir -p ~/.agents/skills
cd ~/.agents/skills
git clone https://github.com/mxyhi/ok-skills.git ok-skills

After cloning, the repo lives at ~/.agents/skills/ok-skills, and the directories inside already follow the expected layout:

~/.agents/skills/ok-skills/
  planning-with-files/
    SKILL.md
  find-docs/
    SKILL.md
  agent-browser/
    SKILL.md
  ...

Add simple trigger rules to your AGENTS.md:

## Skills

- planning-with-files: Use for complex tasks, research, or anything that will take 5+ tool calls.
- find-docs: Use when you need current library docs, API references, or Context7-backed examples.
- agent-browser: Use for browser automation, screenshots, scraping, web testing, or form filling.

Then ask naturally:

• Use planning-with-files before refactoring this module.
• Use find-docs to fetch the latest docs for this SDK.
• Use agent-browser to reproduce this UI bug.

Browse Skills by Use Case

Research & Docs

• find-docs: focused Context7 CLI workflow for current documentation lookup.
• exa-search: web, code, and company research with Exa search tools.
• get-api-docs: fetch current third-party API and SDK documentation before coding.
• find-skills: discover existing skills when a user asks for a capability.

Planning & Prompting

• brainstorming: explore ideas, requirements, and design before implementation begins.
• planning-with-files: persistent markdown planning with task_plan.md, findings.md, and progress.md.
• autoresearch: autonomous goal-directed iteration with explicit goals, metrics, verify loops, and keep/discard gates.
• improve-codebase-architecture: find deepening opportunities that improve locality, leverage, testability, and AI navigation.
• migrate-to-shoehorn: migrate test as assertions to @total-typescript/shoehorn.
• tdd: test-first red-green-refactor for features, bugfixes, refactors, and behavior changes.
• systematic-debugging: investigate root causes methodically before proposing fixes.

GitHub Workflow

• gh-address-comments: address review and issue comments on the current PR with gh.
• gh-fix-ci: inspect failing GitHub Actions checks, summarize logs, and plan fixes.
• yeet: use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one gh-driven flow.

Automation & QA

• agent-browser: browser automation for navigation, forms, screenshots, and scraping.
• browser-use: persistent browser automation CLI for navigation, state inspection, form filling, screenshots, and extraction.
• browser-trace: CDP trace capture for browser automation runs, with screenshots, DOM dumps, and per-page buckets.
• opencli: turn websites into CLI commands with browser session reuse, public API access, and AI-generated adapters.
• dogfood: structured exploratory testing with reproducible evidence.
• electron: automate Electron desktop apps over Chrome DevTools Protocol.

dogfood/ and electron/ are still vendored from vercel-labs/agent-browser, but upstream moved them from skills/ to skill-data/ in commit 7c2ff0a2a624e86cec0bcc9cc0835aeff6a2edf0 so installer discovery only exposes the bootstrap agent-browser skill. This repo keeps those specialized skills as top-level directories because they are still maintained upstream and remain directly usable.

Frontend & Design

• ai-elements: build AI chat UI components for the ai-elements library.
• frontend-skill: use when you need a visually strong landing page, website, app, prototype, demo, or game UI.
• shader-dev: comprehensive GLSL shader techniques for ShaderToy-compatible real-time visual effects.
• better-icons: search, browse, and retrieve SVG icons from 200+ Iconify libraries via CLI or MCP.
• gsap-skills/: 8 official GSAP animation skills: core, timelines, ScrollTrigger, plugins, utils, React, performance, frameworks.

Utilities & Authoring

• minimax-docx: professional DOCX creation, editing, and formatting with OpenXML SDK (.NET).
• minimax-pdf: generate, fill, and reformat PDFs with a token-based design system.
• pptx-generator: generate, edit, and read PowerPoint presentations with PptxGenJS, XML workflows, or markitdown.
• minimax-xlsx: open, create, read, analyze, edit, and validate Excel or spreadsheet files with low-loss XML workflows.

Vendored Skill Packs

gsap-skills/ contains an animation-focused bundle vendored from greensock/gsap-skills at commit aed9cfd3277740755f6bfc1155c7aa645403b760.

It includes:

• gsap-core
• gsap-timeline
• gsap-scrolltrigger
• gsap-plugins
• gsap-utils
• gsap-react
• gsap-performance
• gsap-frameworks

Attribution and legal files are preserved in gsap-skills/NOTICE.md and gsap-skills/LICENSE.

planning-with-files/ tracks OthmanAdi/planning-with-files/.pi/skills/planning-with-files as its upstream baseline. This repository keeps the generic planning-with-files name and removes Pi-specific package metadata so the skill stays compatible with standard SKILL.md workflows.

Common Prerequisites

• Some skills assume gh is installed and authenticated.
• Browser-focused skills may require a Chrome/CDP-capable environment.
• Third-party doc lookup skills may depend on external CLIs or MCP tools; check each SKILL.md for details.

Full Skill Index

Source URL points to the canonical upstream when a skill is vendored/imported; otherwise it points to the skill directory in this repository.

Top-Level Skills

| Skill | Description | Source URL | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | agent-browser | Browser automation CLI for AI agents: navigation, form filling, screenshots, extraction, and web testing. | [vercel-labs/agent-browser](https://github.com/vercel-la