Ok Skills

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 33 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, task management, 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, 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.
• reverse-engineer-anything: investigate shipped applications and binaries when source code does not explain behavior; use REA's CLI/MCP to gather evidence and compare versions.
• 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.
• ax: AI-era curl — fetch pages, discover structure, extract structured data without throwaway parsing scripts.

Planning & Prompting

• planning-with-files: persistent markdown planning with task_plan.md, findings.md, and progress.md.
• ledger-tasks-yylo: durable in-repo task state for coding agents — Kanban tasks with stable IDs, evidence-backed status marks, blocked-by dependencies, and next-ready selection.
• 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 design-tree 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, GLOSSARY.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.
• 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.
• ponytail: Apply YAGNI, reuse existing code, and prefer standard-library and native-platform solutions to reduce over-engineering; supports lite, full, and ultra modes.
• 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.
• orca-replay: answer questions about an earlier agent run from its recording instead of from memory, and replay or fork that run offline.

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.
• better-icons: search, browse, and retrieve SVG icons from 200+ Iconify libraries via CLI or MCP.
• unslop: turn AI-looking interfaces into deliberate, product-specific designs through a structured visual polish pass.

Utilities & Authoring

• bopomofo-rescue: recover Chinese typed on a Taiwanese Bopomofo (注音) keyboard while the IME was stuck in English mode, e.g. su3cl3a8 → 你好嗎.
• huashu-design: create HTML decks, editable PPTX exports, MP4/GIF motion pieces, and narrated design videos.

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.

Upstream Migration Notes (2026-09-30)

• The Matt Pocock engineering skills now use GLOSSARY.md and GLOSSARY-MAP.md for domain vocabulary. Existing CONTEXT.md / CONTEXT-MAP.md glossaries need to be renamed and their links updated; ADRs stay under docs/adr/.
• OpenCLI upstream removed sitemap skills, bundled sitemaps, and external CLI passthrough. Use the current browser/adapter skills and site memory; invoke external CLIs directly.

Upstream Migration Notes (2026-10-18)

• OpenCLI commands now default to {ok:true,data:...} JSON results. Adapter creation and validation use opencli adapter init|check|test; update scripts that parse the old output or use the former browser adapter commands. The CLI itself must support these commands.
• Huashu Design 3.0 organizes work by output module and starts new visual designs with six thumbnails and three complete directions for selection. Pure exports and mechanical edits are exempt.
• Kimi WebBridge skill 2.0.24 documents tab attachment and paginated ARIA snapshots. These features require a matching daemon and browser extension; syncing this repository only updates the skill files.

Upstream Migration Notes (2026-10-29)

• Planning with Files 3.26.0 adds explicit plan-format validation (check-complete.sh --validate / check-complete.ps1 -Validate). New plans must retain native phase headings and status markers; existing plans are reported without being rewritten. PWF_SKIP_SUBAGENTS=1 optionally skips subagent tool-hook injection.
• REA skill version 55 adds AgentEnv bundles, more artifact/runtime workflows, and separate recovery guidance for plugin-owned and setup-owned MCP registrations. Use the capabilities advertised by the installed REA runtime; syncing the skill does not upgrade it.
• imagegen-frontend-web moved to Leonxlnx/imagegen-skills. Its skill name and vendored content are unchanged.

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
ax	AI-era curl: fetch URLs, discover page structure, and extract structured data from HTML without throwaway parsing scripts.	yusukebe/ax

| better-icons | Search 200+ Iconify libraries and retrieve SVG icons through CLI or MCP tools. | better-auth/better-icons | | bopomofo-rescue | Recover Chinese typed on a Taiwanese Bopomofo (注音) keyboard while the IME was stuck in English mode, e.g. su3cl3a8 → 你好嗎. | Oliviaiii/bopomofo-rescue | | 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 | | diagnosing-bugs | Disciplined diagnosis loop for hard bugs and performance regressions. | mattpocock/skills | | deep-research | Professional deep research reports with multi-agent parallel writing, current-data targeting, multilingual output, and built-in quality checks. | hoolulu/deep-research | | find-docs | Use the Context7 CLI for current documentation lookup, API references, and code examples. | upstash/context7 | | exa-search | Use Exa for web, code, and company research. | Custom | | reverse-engineer-anything | Investigate shipped applications and binaries when source code does not explain behavior; use REA's CLI/MCP to gather evidence and compare versions. | morluto/rea | | find-skills | Discover existing skills when users need specialized capabilities. | vercel-labs/skills | | huashu-design | Create high-fidelity HTML prototypes, interactive demos, slide decks, motion design, design variants, video exports, and critiques. | alchaincyf/huashu-design | | imagegen-frontend-web | Generate premium frontend reference images, one horizontal image per section, with strong art direction. | Leonxlnx/imagegen-skills | | unslop | Turn AI-looking interfaces into deliberate, product-specific designs through a structured visual polish pass. | heydamir/unslop | | get-api-docs | Fetch current third-party API or SDK docs before writing code. | andrewyng/context-hub | | grilling | Reusable design-tree interview loop for direct grill sessions. | mattpocock/skills | | teach | Teach a user a skill or concept through a stateful workspace of missions, resources, lessons, and learning records. | mattpocock/skills | | domain-modeling | Build and sharpen project domain terminology, GLOSSARY.md, and ADRs. | mattpocock/skills | | codebase-design | Shared deep-module vocabulary for seams, interfaces, leverage, locality, and testability. | mattpocock/skills | | improve-codebase-architecture | Find deepening opportunities that improve locality, leverage, testability, and AI navigation. | mattpocock/skills | | prototype | Build throwaway logic or UI prototypes to answer design questions quickly. | mattpocock/skills | | karpathy-guidelines | Behavioral coding guidelines that reduce overcomplication, hidden assumptions, and unverifiable changes. | forrestchang/andrej-karpathy-skills | | ponytail | Apply YAGNI, reuse existing code, and prefer standard-library and native-platform solutions to reduce over-engineering; supports lite, full, and ultra modes. | DietrichGebert/ponytail | | migrate-to-shoehorn | Migrate test files from as type assertions to @total-typescript/shoehorn. | mattpocock/skills | | opencli | Turn websites into CLI commands with browser session reuse, public API access, and AI-generated adapters. | jackwener/opencli | | planning-with-files | File-based planning for complex tasks using task_plan.md, findings.md, and progress.md. | OthmanAdi/planning-with-files | | product-decision-agent | Chinese-first product decision support for bottleneck diagnosis, prioritization, growth, metrics, operations, and cross-team delivery. | atdy/maoxuan-product-agent | | ledger-tasks-yylo | Durable in-repo task state for coding agents: Kanban tasks with stable IDs, evidence-backed status marks, blocked-by dependencies, and next-ready selection. | yylo-dev/yylo-skills | | tdd | Use before any feature, bugfix, refactor, or behavior change; prefers public-interface integration tests. | mattpocock/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.