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

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 auth

ok-skills

Related Skills