OK Skills: AI Coding Agent Skills for Codex, Claude Code, Cursor, OpenClaw, Autohand Code, 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, Autohand Code, Trae, and other SKILL.md-compatible tools.

This repo currently bundles 32 reusable skills, all maintained as top-level skill directories in this repo. 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, prompt engineering, planning workflows, codebase understanding, frontend design, PDF/Word/PPTX/XLSX authoring.

Who This Repo Is For

• You use Codex, Claude Code, Cursor, OpenClaw, Autohand Code, 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, 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.

1-Minute Quick Start

mkdir -p ~/.agents/skills
cd ~/.agents/skills
git clone https://github.com/mxyhi/ok-skills.git ok-skills

For Autohand Code, clone the repo into either the user-level or project-level skills directory:

# User-level skills
mkdir -p ~/.autohand/skills
git clone https://github.com/mxyhi/ok-skills.git ~/.autohand/skills/ok-skills

# Project-level skills
mkdir -p .autohand/skills
git clone https://github.com/mxyhi/ok-skills.git .autohand/skills/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.
• product-decision-agent: Chinese-first product decision support for bottleneck diagnosis, prioritization, growth, metrics, operations, and cross-team delivery.
• autoresearch: autonomous goal-directed iteration with explicit goals, metrics, verify loops, and keep/discard gates.
• diagnosing-bugs: disciplined diagnosis loop for hard bugs and performance regressions.
• grilling: reusable one-question-at-a-time interview loop for direct grill sessions.
• teach: run a stateful teaching workspace with missions, resources, lessons, and learning records.
• domain-modeling: build and sharpen project domain terminology, CONTEXT.md, and ADRs.
• codebase-design: shared deep-module vocabulary for seams, interfaces, leverage, locality, and testability.
• improve-codebase-architecture: find deepening opportunities that improve locality, leverage, testability, and AI navigation.
• ontoly-software-graph: use Ontoly's deterministic Software Graph and MCP capabilities for architecture review, request tracing, dependency analysis, configuration lookup, and impact analysis.
• prototype: build throwaway logic or UI prototypes to answer design questions quickly.
• 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.

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.

Frontend & Design

• ai-elements: build AI chat UI components for the ai-elements library.
• huashu-design: produce high-fidelity HTML prototypes, slide decks, motion demos, design variants, video exports, and design critiques.
• imagegen-frontend-web: generate premium frontend reference images, one horizontal image per section, with strong art direction.
• gpt-taste: build AIDA-structured, motion-rich frontend pages with randomized layouts and GSAP patterns.
• better-icons: search, browse, and retrieve SVG icons from 200+ Iconify libraries via CLI or MCP.

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

planning-with-files/ tracks OthmanAdi/planning-with-files/.codex/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 skills-ref-compatible SKILL.md frontmatter and install-location-independent relative script paths in docs.

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