Skip to content

mxyhi/ok-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, Trae, and other SKILL.md-compatible tools.

This repo currently bundles 53 reusable skills: 27 top-level skills maintained directly in this repo, plus 18 vendored design skills under impeccable/, 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.

If you are looking for Codex skills, Claude Code skills, Cursor skills, OpenClaw skills, reusable 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 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:

  • brainstorming: explore ideas, requirements, and design before implementation begins.
  • planning-with-files: file-based planning for complex tasks, research, and long-running work.
  • context7-cli: fetch current library docs and Context7-backed references.
  • 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.
  • impeccable: core impeccable design skill plus a full bundle of companion design commands.

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/
  planning-with-files/
    SKILL.md
  context7-cli/
    SKILL.md
  agent-browser/
    SKILL.md
  ...

Add simple trigger rules to your AGENTS.md:

## Skills

- planning-with-files: Use for complex tasks, research, or anything that will take 5+ tool calls.
- context7-cli: 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 context7-cli to fetch the latest docs for this SDK.
  • Use agent-browser to reproduce this UI bug.

Browse Skills by Use Case

Research & Docs

  • context7-cli: official Context7 CLI workflow for docs lookup, skill management, and MCP setup.
  • 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

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.
  • yeet: use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one gh-driven flow.

Automation & QA

  • agent-browser: browser automation for navigation, forms, screenshots, and scraping.
  • browser-use: persistent browser automation CLI for navigation, state inspection, form filling, screenshots, and extraction.
  • 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.
  • 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.
  • remotion-best-practices: Remotion guidance for React-based video work.
  • gsap-skills/: 8 official GSAP animation skills: core, timelines, ScrollTrigger, plugins, utils, React, performance, frameworks.
  • impeccable/: 18 vendored frontend design skills, including impeccable, adapt, audit, polish, and more.

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.
  • minimax-xlsx: open, create, read, analyze, edit, and validate Excel or spreadsheet files with low-loss XML workflows.
  • skill-creator: create or update skills with stronger structure and tool integrations.

Vendored Skill Packs

impeccable/ contains a vendored design-focused bundle from pbakaus/impeccable at commit 00d485659af82982aef0328d0419c49a2716d123.

It includes:

  • impeccable: the flagship frontend design skill
  • adapt, animate, audit, bolder, clarify, colorize, critique, delight, distill
  • harden, layout, optimize, overdrive, polish, quieter, shape, typeset

Attribution and legal files are preserved in impeccable/NOTICE.md and impeccable/LICENSE.

gsap-skills/ contains an animation-focused bundle vendored from greensock/gsap-skills at commit 03d9f0c3dbf91e0b60582b64ed040c8911ca0174.

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.

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
better-icons Search 200+ Iconify libraries and retrieve SVG icons through CLI or MCP tools. better-auth/better-icons
brainstorming Turn ideas into validated designs and specs through collaborative dialogue before implementation. obra/superpowers
browser-use Persistent browser automation CLI for navigation, state inspection, form filling, screenshots, and extraction. browser-use/browser-use
caveman Ultra-compressed communication mode that cuts response tokens by speaking like caveman while keeping technical accuracy. JuliusBrussee/caveman
context7-cli Use the Context7 CLI for docs lookup, skill management, and MCP setup. 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
frontend-skill Build visually strong landing pages, websites, apps, prototypes, demos, or game UIs. ok-skills/frontend-skill
shader-dev Comprehensive GLSL shader techniques for ShaderToy-compatible real-time visual effects. MiniMax-AI/skills
get-api-docs Fetch current third-party API or SDK docs before writing code. andrewyng/context-hub
gh-address-comments Address PR review and issue comments on the current branch with gh. openai/skills
gh-fix-ci Inspect failing GitHub Actions checks, pull logs, and plan fixes. openai/skills
opensrc Fetch dependency source code to give AI agents deeper implementation context. vercel-labs/opensrc
opencli Turn websites into CLI commands with browser session reuse, public API access, and AI-generated adapters. jackwener/opencli
dogfood Systematically test web apps and produce reproducible issue reports with screenshots and videos. vercel-labs/agent-browser
electron Automate Electron desktop apps through agent-browser and Chrome DevTools Protocol. vercel-labs/agent-browser
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
remotion-best-practices Best practices for building videos in React with Remotion. remotion-dev/skills
skill-creator Guide for creating or updating skills with specialized knowledge and tool integrations. openai/skills
test-driven-development Use before implementing any feature or bugfix. obra/superpowers
minimax-xlsx Open, create, read, analyze, edit, and validate Excel or spreadsheet files with low-loss XML workflows. MiniMax-AI/skills
yeet Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using gh. openai/skills

Notes:

  • dogfood and electron come from upstream skill-data/, not upstream skills/.
  • Upstream moved these specialized skills in commit 7c2ff0a2a624e86cec0bcc9cc0835aeff6a2edf0 so installer discovery only finds the bootstrap agent-browser skill.
  • This repository intentionally keeps them as top-level vendored skills because they are still maintained upstream and remain directly useful.

Vendored impeccable/ Skills

Skill Description Source URL
impeccable Create distinctive, production-grade frontend interfaces with high design quality. pbakaus/impeccable
adapt Adapt designs across screen sizes, devices, and contexts. pbakaus/impeccable
animate Add purposeful motion and micro-interactions. pbakaus/impeccable
audit Audit interface quality across accessibility, performance, theming, and responsive design. pbakaus/impeccable
bolder Make safe or boring designs more visually interesting. pbakaus/impeccable
clarify Improve unclear UX copy and instructions. pbakaus/impeccable
colorize Add strategic color to overly monochrome features. pbakaus/impeccable
critique Evaluate design effectiveness from a UX perspective. pbakaus/impeccable
delight Add personality and memorable moments to interfaces. pbakaus/impeccable
distill Strip designs down to their essential form. pbakaus/impeccable
harden Improve resilience around errors, i18n, overflow, and edge cases. pbakaus/impeccable
layout Improve layout, spacing, and visual rhythm. pbakaus/impeccable
optimize Improve frontend performance, rendering, motion, and bundle efficiency. pbakaus/impeccable
overdrive Push interfaces past conventional limits with technically ambitious implementations. pbakaus/impeccable
polish Final quality pass for alignment, spacing, consistency, and detail. pbakaus/impeccable
quieter Reduce visual aggression while preserving design quality. pbakaus/impeccable
shape Plan the UX and UI for a feature before writing code. pbakaus/impeccable
typeset Improve typography by fixing font choices, hierarchy, sizing, weight, and readability. pbakaus/impeccable

Vendored gsap-skills/ Skills

Skill Description Source URL
gsap-core Core API: gsap.to()/from()/fromTo(), easing, duration, stagger, defaults, matchMedia. greensock/gsap-skills
gsap-timeline Timelines: sequencing, position parameter, labels, nesting, playback. greensock/gsap-skills
gsap-scrolltrigger ScrollTrigger: scroll-linked animation, pinning, scrub, triggers, refresh, cleanup. greensock/gsap-skills
gsap-plugins Plugins: Flip, Draggable, MotionPath, ScrollToPlugin, CustomEase, and more. greensock/gsap-skills
gsap-utils gsap.utils helpers: clamp, mapRange, normalize, random, snap, toArray, wrap, pipe. greensock/gsap-skills
gsap-react React: useGSAP, refs, gsap.context(), cleanup, SSR. greensock/gsap-skills
gsap-performance Performance tips: transforms, will-change, batching, ScrollTrigger tips. greensock/gsap-skills
gsap-frameworks Vue, Svelte, and other frameworks: lifecycle, scoping selectors, cleanup on unmount. greensock/gsap-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.

Some skills include additional license files or notices for skill-specific assets and attribution, including caveman/, minimax-docx/, impeccable/, gsap-skills/, and skill-creator/.

About

Curated AI coding agent skills and AGENTS.md playbooks for Codex, Claude Code, Cursor, OpenClaw, and other SKILL.md-compatible tools.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors