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 55 reusable skills: 29 top-level skills maintained directly in this repo, plus 18 vendored design skills under impeccable/, 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:

• 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.
• prompt-engineering-patterns: production-oriented prompt patterns for more reliable LLM workflows.
• impeccable/frontend-design: high-quality frontend design skill plus a full bundle of companion design commands.

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

• planning-with-files: persistent markdown planning with task_plan.md, findings.md, and progress.md.
• prompt-engineering-patterns: advanced prompt design patterns for production LLM systems.
• subagent-driven-development: execute implementation plans with independent tasks in the current session using fresh subagents and staged reviews.
• test-driven-development: enforce writing tests before implementation work.

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.
• bb-browser: information retrieval and browser automation through the user's real browser and logged-in session.
• pinchtab: control Chrome through Pinchtab's local HTTP API using stable accessibility refs.
• electron: automate Electron desktop apps over Chrome DevTools Protocol.
• opencli: turn websites into CLI commands with browser session reuse, public API access, and AI-generated adapters.
• dogfood: structured exploratory testing with reproducible evidence.

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.
• vercel-react-best-practices: React and Next.js performance guidance from Vercel Engineering.
• 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.
• impeccable/: 18 vendored frontend design skills, including frontend-design, adapt, audit, polish, and more.

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.
• skill-creator: create or update skills with stronger structure and tool integrations.

Vendored Skill Packs

impeccable/ contains a vendored design-focused bundle from pbakaus/impeccable at commit 9d368b777d222e213c9a8f4fa78f6f1d29cb492d.

It includes:

• frontend-design: the flagship frontend design skill
• adapt, animate, audit, bolder, clarify, colorize, critique, delight, distill
• extract, harden, normalize, onboard, optimize, polish, quieter, teach-impeccable

Attribution and legal files are preserved in impeccable/NOTICE.md and impeccable/LICENSE.

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

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

Vendored impeccable/ Skills

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