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 40 reusable skills: 27 top-level skills maintained directly in this repo, plus 5 vendored HyperFrames video skills under hyperframes/, 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.
• context7-cli: fetch current library docs and Context7-backed references.
• 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
  context7-cli/
    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.
- context7-cli: 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 context7-cli to fetch the latest docs for this SDK.
• Use agent-browser to reproduce this UI bug.

Browse Skills by Use Case

Research & Docs

• context7-cli: official Context7 CLI workflow for docs lookup, skill management, and MCP setup.
• 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.
• test-driven-development: enforce writing tests before implementation work.
• 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.
• 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.
• remotion-best-practices: Remotion guidance for React-based video work.
• gsap-skills/: 8 official GSAP animation skills: core, timelines, ScrollTrigger, plugins, utils, React, performance, frameworks.

Video & Motion

• hyperframes: create HTML-native video compositions, captions, TTS voiceovers, audio-reactive visuals, and scene transitions.
• hyperframes-cli: scaffold, lint, preview, render, transcribe, and troubleshoot HyperFrames projects.
• hyperframes-registry: install registry blocks and components, then wire them into compositions.
• gsap: HyperFrames-focused GSAP reference for timelines, easing, effects, and performance.
• website-to-hyperframes: capture a website and turn it into a scripted HyperFrames promo or product video.

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

hyperframes/ contains a video-focused bundle vendored from heygen-com/hyperframes at commit 42d39866ffb52c1c377f5f384b760f2de8519982.

It includes:

• hyperframes
• hyperframes-cli
• hyperframes-registry
• gsap
• website-to-hyperframes

Attribution and legal files are preserved in hyperframes/LICENSE.

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

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.

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
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
caveman	Ultra-compressed communication mode that cuts response tokens by speaking like caveman while keeping technical accuracy.	JuliusBrussee/caveman
context7-cli	Use the Context7 CLI for docs lookup, skill management, and MCP setup.	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
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
remotion-best-practices	Best practices for building videos in React with Remotion.	remotion-dev/skills
test-driven-development	Use before implementing any feature or bugfix.	obra/superpowers
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 hyperframes/ Skills

Skill	Description	Source URL
hyperframes	Create HTML-native video compositions, captions, TTS voiceovers, audio-reactive visuals, and transitions.	heygen-com/hyperframes
hyperframes-cli	CLI workflow for HyperFrames: init, lint, preview, render, transcribe, TTS, and environment diagnosis.	heygen-com/hyperframes
hyperframes-registry	Install registry blocks/components and wire them into HyperFrames compositions.	heygen-com/hyperframes
gsap	HyperFrames-focused GSAP reference for timelines, easing, effects, and performance.	heygen-com/hyperframes
website-to-hyperframes	Capture a website and turn it into a HyperFrames video workflow with design, script, storyboard, voiceover, and build steps.	heygen-com/hyperframes

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/, minimax-docx/, and gsap-skills/.