Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/mxyhi/ok-skills

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

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

Name: ok-skills
Author: mxyhi

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 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, 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.
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.
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, 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.
diagram-design: create branded editorial diagrams as self-contained HTML/SVG/PNG — architecture, flowchart, sequence, and 24 more types. Redraw draw.io or Mermaid.

Utilities & Authoring

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.

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.
diagram-design PNG export needs Playwright and Chromium: pip install playwright && playwright install chromium.

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

Contributing

Contributions are welcome for new skills or improvements to existing ones.

Keep trigger conditions explicit and testable.
Keep examples concise and execution-oriented.
If a skill depends on external tools, document that dependency in SKILL.md.
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.

Frequently Asked Questions

What is ok-skills?⌄

ok-skills is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by mxyhi. Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, and other SKILL.md-compatible tools. It has 480 GitHub stars.

Is ok-skills safe to use?⌄

Yes. ok-skills passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install ok-skills?⌄

Clone the repository with "git clone https://github.com/mxyhi/ok-skills" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is ok-skills written in?⌄

ok-skills is primarily written in HTML. It is open-source under mxyhi on GitHub, so you can review or fork the full source.

Are there alternatives to ok-skills?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh ok-skills against similar tools.

ok-skills