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 CLAUDE.md / AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, Trae, and other SKILL.md-compatible tools.

This repo currently bundles 42 reusable skills: 34 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, and CLAUDE_AGENTS.md provides a Claude Code-oriented agent playbook.

If you are looking for Codex skills, Claude Code skills, Cursor skills, OpenClaw skills, reusable CLAUDE.md / 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 CLAUDE.md / 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:

• 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/
  CLAUDE_AGENTS.md
  planning-with-files/
    SKILL.md
  find-docs/
    SKILL.md
  agent-browser/
    SKILL.md
  ...

For Claude Code or Codex global instructions, start from CLAUDE_AGENTS.md and copy or merge it into Claude Code's CLAUDE.md or Codex's AGENTS.md. It packages a Chinese-first, KISS-oriented workflow with current-doc/source checks, multi-agent preference, caveman / planning-with-files / karpathy-guidelines defaults, strict TypeScript expectations, and context-mode routing rules. Before reusing it, edit the 语言要求 section for your project. The 其他注意项 section is intentionally project-local and can be edited as needed.

Add simple trigger rules to your AGENTS.md, or merge the same skill triggers into CLAUDE.md / 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

• 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.
• diagnose: disciplined diagnosis loop for hard bugs and performance regressions.
• grill-me: stress-test a plan or design through a focused one-question-at-a-time interview.
• grill-with-docs: challenge a plan against domain language, CONTEXT.md, and ADRs while updating docs inline.
• improve-codebase-architecture: find deepening opportunities that improve locality, leverage, testability, and AI navigation.
• karpathy-guidelines: behavioral coding guidelines that reduce overcomplication, hidden assumptions, and unverifiable changes.
• 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.

Automation & QA

• agent-browser: browser automation for navigation, forms, screenshots, and scraping.
• kimi-webbridge: control the user's real browser through a local daemon for navigation, forms, screenshots, page reading, and authenticated sessions.
• 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.
• huashu-design: produce high-fidelity HTML prototypes, slide decks, motion demos, design variants, video exports, and design critiques.
• text-to-lottie: author Skia/Skottie-renderable Lottie JSON animations in the official Diffusion Studio player.
• 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.
• huashu-design: create HTML decks, editable PPTX exports, MP4/GIF motion pieces, and narrated design videos.
• 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 that upstream directory as the canonical baseline for the local skill. Local differences are limited to keeping the public skill name planning-with-files and normalizing SKILL.md frontmatter for skills-ref compatibility.

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
kimi-webbridge	Control the user's real browser through a local daemon for navigation, forms, screenshots, page reading, and authenticated sessions.	install.sh
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
diagnose	Disciplined diagnosis loop for hard bugs and performance regressions.	mattpocock/skills
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
huashu-design	Create high-fidelity HTML prototypes, interactive demos, slide decks, motion design, design variants, video exports, and critiques.	alchaincyf/huashu-design
text-to-lottie	Author Skia/Skottie-renderable Lottie JSON animations in the official Diffusion Studio player.	diffusionstudio/lottie
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
grill-me	Interview the user relentlessly about a plan or design until shared understanding is reached.	mattpocock/skills
grill-with-docs	Stress-test a plan against domain language, CONTEXT.md, and ADRs, updating documentation inline.	mattpocock/skills
improve-codebase-architecture	Find deepening opportunities that improve locality, leverage, testability, and AI navigation.	mattpocock/skills
karpathy-guidelines	Behavioral coding guidelines that reduce overcomplication, hidden assumptions, and unverifiable changes.	forrestchang/andrej-karpathy-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

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/, diagnose/, grill-me/, grill-with-docs/, improve-codebase-architecture/, migrate-to-shoehorn/, huashu-design/, text-to-lottie/, minimax-docx/, and gsap-skills/.