Skip to content

README.md

Latest commit

 

History

History
175 lines (131 loc) · 20.7 KB

README.md

File metadata and controls

175 lines (131 loc) · 20.7 KB

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

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Español | Tiếng Việt | Русский | हिन्दी

Mentioned in Awesome Codex CLI

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 30 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, 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, 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

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.
  • diagnosing-bugs: 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.
  • grilling: reusable one-question-at-a-time interview loop behind grill-me and grill-with-docs.
  • 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.
  • 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.

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.
  • xquik-twitter: search X/Twitter data and run approval-gated account actions through the Xquik API.

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.
  • 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/.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 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
better-icons Search 200+ Iconify libraries and retrieve SVG icons through CLI or MCP tools. better-auth/better-icons
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
caveman Ultra-compressed communication mode that cuts response tokens by speaking like caveman while keeping technical accuracy. JuliusBrussee/caveman
diagnosing-bugs Disciplined diagnosis loop for hard bugs and performance regressions. mattpocock/skills
find-docs Use the Context7 CLI for current documentation lookup, API references, and code examples. 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
huashu-design Create high-fidelity HTML prototypes, interactive demos, slide decks, motion design, design variants, video exports, and critiques. alchaincyf/huashu-design
get-api-docs Fetch current third-party API or SDK docs before writing code. andrewyng/context-hub
grill-me Interview the user relentlessly about a plan or design until shared understanding is reached. mattpocock/skills
grill-with-docs Stress-test a plan against domain language, CONTEXT.md, and ADRs, updating documentation inline. mattpocock/skills
grilling Reusable one-question-at-a-time interview loop behind grill-me and grill-with-docs. mattpocock/skills
domain-modeling Build and sharpen project domain terminology, CONTEXT.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
karpathy-guidelines Behavioral coding guidelines that reduce overcomplication, hidden assumptions, and unverifiable changes. forrestchang/andrej-karpathy-skills
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
xquik-twitter Search X/Twitter data and run approval-gated account actions through the Xquik API. Xquik-dev/x-twitter-scraper
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
tdd Use before any feature, bugfix, refactor, or behavior change; prefers public-interface integration tests. mattpocock/skills
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

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.