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
ai-elements	Create new AI chat interface components for the ai-elements library with composable patterns and shadcn/ui conventions.	vercel/ai-elements
autoresearch	Autonomous goal-directed iteration engine for modify, verify, keep/discard, and repeat workflows.	uditgoenka/autoresearch
better-icons	Search 200+ Iconify libraries and retrieve SVG icons through CLI or MCP tools.	better-auth/better-icons
brainstorming	Turn ideas into validated designs and specs through collaborative dialogue before implementation.	obra/superpowers
browser-use	Persistent browser automation CLI for navigation, state inspection, form filling, screenshots, and extraction.	browser-use/browser-use
browser-trace	Capture CDP traces, screenshots, and DOM dumps for browser automation debugging.	browserbase/skills
caveman	Ultra-compressed communication mode that cuts response tokens by speaking like caveman while keeping technical accuracy.	JuliusBrussee/caveman
find-docs	Use the Context7 CLI for current documentation lookup, API references, and code examples.	upstash/context7
minimax-docx	Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET).	MiniMax-AI/skills
exa-search	Use Exa for web, code, and company research.	Custom
find-skills	Discover existing skills when users need specialized capabilities.	vercel-labs/skills
frontend-skill	Build visually strong landing pages, websites, apps, prototypes, demos, or game UIs.	ok-skills/frontend-skill
shader-dev	Comprehensive GLSL shader techniques for ShaderToy-compatible real-time visual effects.	MiniMax-AI/skills
get-api-docs	Fetch current third-party API or SDK docs before writing code.	andrewyng/context-hub
gh-address-comments	Address PR review and issue comments on the current branch with gh.	openai/skills
gh-fix-ci	Inspect failing GitHub Actions checks, pull logs, and plan fixes.	openai/skills
improve-codebase-architecture	Find deepening opportunities that improve locality, leverage, testability, and AI navigation.	mattpocock/skills
migrate-to-shoehorn	Migrate test files from as type assertions to @total-typescript/shoehorn.	mattpocock/skills
opensrc	Fetch dependency source code to give AI agents deeper implementation context.	vercel-labs/opensrc
opencli	Turn websites into CLI commands with browser session reuse, public API access, and AI-generated adapters.	jackwener/opencli
dogfood	Systematically test web apps and produce reproducible issue reports with screenshots and videos.	vercel-labs/agent-browser
electron	Automate Electron desktop apps through agent-browser and Chrome DevTools Protocol.	vercel-labs/agent-browser
minimax-pdf	Generate, fill, and reformat PDF documents with a token-based design system.	MiniMax-AI/skills
planning-with-files	File-based planning for complex tasks using task_plan.md, findings.md, and progress.md.	OthmanAdi/planning-with-files
pptx-generator	Generate, edit, and read PowerPoint presentations with PptxGenJS, XML workflows, or markitdown.	MiniMax-AI/skills
tdd	Use before any feature, bugfix, refactor, or behavior change; prefers public-interface integration tests.	mattpocock/skills
systematic-debugging	Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.	obra/superpowers
minimax-xlsx	Open, create, read, analyze, edit, and validate Excel or spreadsheet files with low-loss XML workflows.	MiniMax-AI/skills
yeet	Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using gh.	openai/skills

Notes:

• dogfood and electron come from upstream skill-data/, not upstream skills/.
• Upstream moved these specialized skills in commit 7c2ff0a2a624e86cec0bcc9cc0835aeff6a2edf0 so installer discovery only finds the bootstrap agent-browser skill.
• This repository intentionally keeps them as top-level vendored skills because they are still maintained upstream and remain directly useful.

Vendored gsap-skills/ Skills

Skill	Description	Source URL
gsap-core	Core API: gsap.to()/from()/fromTo(), easing, duration, stagger, defaults, matchMedia.	greensock/gsap-skills
gsap-timeline	Timelines: sequencing, position parameter, labels, nesting, playback.	greensock/gsap-skills
gsap-scrolltrigger	ScrollTrigger: scroll-linked animation, pinning, scrub, triggers, refresh, cleanup.	greensock/gsap-skills
gsap-plugins	Plugins: Flip, Draggable, MotionPath, ScrollToPlugin, CustomEase, and more.	greensock/gsap-skills
gsap-utils	gsap.utils helpers: clamp, mapRange, normalize, random, snap, toArray, wrap, pipe.	greensock/gsap-skills
gsap-react	React: useGSAP, refs, gsap.context(), cleanup, SSR.	greensock/gsap-skills
gsap-performance	Performance tips: transforms, will-change, batching, ScrollTrigger tips.	greensock/gsap-skills
gsap-frameworks	Vue, Svelte, and other frameworks: lifecycle, scoping selectors, cleanup on unmount.	greensock/gsap-skills

Contributing

Contributions are welcome for new skills or improvements to existing ones.

1. Keep trigger conditions explicit and testable.
2. Keep examples concise and execution-oriented.
3. If a skill depends on external tools, document that dependency in SKILL.md.
4. Update README.md and README.zh-CN.md when you add or rename a skill, and refresh the other translated READMEs when the public-facing skill index changes.

License

This repository is licensed under LICENSE.

Some skills include additional license files or notices for skill-specific assets and attribution, including caveman/, improve-codebase-architecture/, migrate-to-shoehorn/, minimax-docx/, and gsap-skills/.