This repository offers a curated collection of reusable skills and AGENTS.md playbooks for AI coding agents like Codex, Claude Code, and Cursor. It provides immediately usable, portable instructions for users managing AGENTS.md workflows, aiming to replace ad-hoc prompting with structured, battle-tested capabilities.

How It Works

The project centralizes AI coding agent skills, organized to be directly compatible with AGENTS.md-driven workflows. It includes skills maintained within the repo, alongside vendored skill packs from external projects focusing on video (HyperFrames), frontend design (Impeccable), and animation (GSAP). Users clone the repository into their `~/.agents/skills/` directory, and the internal structure automatically aligns with the expected layout for these workflows.

Quick Start & Requirements

• Primary install:

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

• Non-default prerequisites: gh CLI (authenticated) is assumed for some skills. Browser-focused skills may require a Chrome/CDP-capable environment.
• Links: None explicitly provided beyond the GitHub repository URL.

Highlighted Details

• Bundles over 58 reusable skills, including 27 top-level skills and significant vendored collections for HyperFrames video, Impeccable design, and GSAP animations.
• Key skill categories cover browser automation (agent-browser, browser-use), document authoring (DOCX, PDF, PPTX, XLSX via minimax-* skills), frontend design (impeccable suite), video/motion creation (hyperframes, gsap-skills), research (exa-search, context7-cli), and GitHub workflow management (gh-fix-ci).
• Designed for seamless integration with AGENTS.md, requiring only simple trigger rule additions to activate skills based on natural language requests.

Maintenance & Community

Contributions are welcomed for new skills or improvements. The repository does not list specific community channels (e.g., Discord, Slack) or highlight notable contributors or sponsorships.

Licensing & Compatibility

The repository is primarily licensed under `LICENSE`. Several vendored skill packs (e.g., `impeccable/`, `gsap-skills/`) include their own additional license files or notices. Specific compatibility for commercial use or closed-source linking is not detailed beyond the terms of the primary and vendored licenses.

Limitations & Caveats

The `dogfood/` and `electron/` skills are vendored from `vercel-labs/agent-browser` and retain their upstream structure despite upstream changes, which might affect discovery if not managed carefully. Some specialized skills may depend on external CLIs or MCP tools, necessitating a review of individual `SKILL.md` files for complete setup requirements.